案例 6：绩效等级与奖金系数

本案例对应 JQuick-Java 仓库 USE-CASES.md 的场景 6：绩效等级与奖金系数，属于人力资源领域，解决企业考核周期内「四维加权评分 → S/A/B/C/D 等级映射 → 奖金系数修正 → 奖金金额/晋升资格/PIP 判定」的一体化决策问题。

行业场景

在年度或季度绩效考核周期中，HR 需要先汇总员工的四类考核得分：KPI 得分、项目得分、团队协作得分与考勤得分（均为 0-100 分），按 KPI 50%、项目 20%、协作 15%、考勤 15% 的固定权重加权出综合分。

综合分映射为 S/A/B/C/D 五档绩效等级，每档对应一个基准奖金系数：S 为 1.8、A 为 1.4、B 为 1.1、C 为 0.8、D 为 0.5。在基准系数之上，还要叠加三类调节：管理者职责加成 +0.2、销售激励（S/A 级且年度销售额达到 50 万元加 0.2，销售额达到 20 万元加 0.1）、违规扣减 -0.3，最终系数乘以月度基本工资得到奖金金额。

同一条决策链路上还需要并行产出：晋升资格（总分不低于 85 且无违规记录）、是否强制进入 PIP 绩效改进计划、考勤档位（按考勤得分 95/90/80 分为 3/2/1/0 档），以及面向员工的评语清单（评优入池、违规扣减说明、考勤预警、销售激励说明等）。

这些输出物直接服务于奖金发放、年度晋升池筛选与绩效改进计划跟进。对应场景 6 的 6 组真实员工形态：优秀销售（综合 92.65、S 级、系数 2.0）、低绩效且违规（51.25、D 级、系数 0.2）、管理者 A 级（系数 1.7）、中等 B 级（系数 1.2）、不达标 D 级（系数 0.5）、优秀但违规被取消晋升。

业务痛点

考核权重 50%/20%/15%/15%、S/A/B/C/D 分数线、1.8/1.4/1.1/0.8/0.5 基准系数散落在薪资模块、Excel 模板与硬编码中，年度政策一调整就要协调多处重新发版。
管理者加成、销售激励（50 万/20 万两档）、违规扣减三类调节相互缠绕在同一段 if-else 里，改一个档位容易漏改联动逻辑。
晋升资格「总分 85 且无违规」与 PIP 入口和奖金核算耦合在业务代码中，HR 部门无法独立调参与试算。
系数叠加理论上可能出现负值，各系统缺少统一的下限保护；金额小数位口径（保留两位、四舍五入）也不一致。
决策结果往往只给一个奖金数字，员工质疑时难以回溯综合分、等级、各项加成与扣减的完整依据。
不少 eHR 与薪资系统仍运行在 JDK 8 或国产化信创环境，难以引入 Drools 等重型规则平台。

方案架构

本案例采用标准「六件套」：入参模型与决策结果模型承载数据，规则接口声明口径，XML 脚本外置全部阈值与系数，Service 负责汇总聚合与下限保护，JUnit 以 6 组员工形态回归全部决策路径。

层次	职责	对应文件
领域模型	绩效考核快照、奖金决策结果	PerformanceRecord.java、BonusDecision.java
规则集与 XML	加权、等级、系数、三项调节、晋升与 PIP 共 10 个规则方法	PerformanceRules.java、performance.xml
编排服务	系数聚合与下限保护、金额保留两位小数、晋升线复核、评语组装	PerformanceService.java
测试	6 组员工形态（优秀/低绩效违规/管理者/中等/不达标/优秀违规）	PerformanceServiceTest.java

规则方法拆分

规则方法	口径	分值/输出
`weightedScore`	KPI×50% + 项目×20% + 协作×15% + 考勤×15%	0-100 综合分
`grade`	≥90 S / ≥80 A / ≥70 B / ≥60 C / 否则 D	S/A/B/C/D
`baseCoefficient`	S 1.8 / A 1.4 / B 1.1 / C 0.8 / D 0.5	基准系数
`managerBonus`	管理者 +0.2，否则 0	+0.2 / 0
`salesBonus`	S/A 且销售额 ≥50 万 +0.2；销售额 ≥20 万 +0.1；否则 0	+0.2 / +0.1 / 0
`violationPenalty`	违规 -0.3，否则 0	-0.3 / 0
`promotionEligible`	总分 ≥85 且无违规才具备资格（违规前置一票否决）	true / false
`needPip`	总分低于 60，或低于 70 且有违规 → 进入 PIP	true / false
`attendanceLevel`	考勤 ≥95 为 3 / ≥90 为 2 / ≥80 为 1 / 否则 0	0-3 档
`bonusAmount`	月度基本工资 × 最终奖金系数	奖金金额（元）

代码实现（完整可运行）

将六个文件按仓库原有包结构放入 Maven 工程：两个模型放入 src/test/java/com/github/paohaijiao/demo/model/，规则接口、编排服务与测试分别放入 com.github.paohaijiao.demo 与 com.github.paohaijiao.demo.service 包，XML 脚本放入 src/test/resources/demo/performance.xml，包名全部保持源码原样。工程根目录执行 mvn test -Dtest=PerformanceServiceTest 即可运行。

PerformanceRecord.java

package com.github.paohaijiao.demo.model;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * 绩效考核记录（绩效与奖金核算所需的考核快照）
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
public class PerformanceRecord {

    /**
     * 工号
     */
    private String employeeId;

    /**
     * 姓名
     */
    private String employeeName;

    /**
     * 部门
     */
    private String dept;

    /**
     * KPI 得分（0-100）
     */
    private double kpiScore;

    /**
     * 项目得分（0-100）
     */
    private double projectScore;

    /**
     * 团队协作风得分（0-100）
     */
    private double teamScore;

    /**
     * 考勤得分（0-100）
     */
    private double attendanceScore;

    /**
     * 是否管理者
     */
    private boolean manager;

    /**
     * 是否发生违规
     */
    private boolean hasViolation;

    /**
     * 年度销售额（元）
     */
    private double salesAmount;

    /**
     * 月度基本工资（元）
     */
    private double baseSalary;
}

BonusDecision.java

package com.github.paohaijiao.demo.model;

import lombok.Data;

import java.util.ArrayList;
import java.util.List;

/**
 * 绩效奖金决策结果
 */
@Data
public class BonusDecision {

    /**
     * 工号
     */
    private String employeeId;

    /**
     * 加权总分（0-100）
     */
    private double totalScore;

    /**
     * 绩效等级：S / A / B / C / D
     */
    private String grade;

    /**
     * 最终奖金系数
     */
    private double bonusCoefficient;

    /**
     * 奖金金额（元）
     */
    private double bonusAmount;

    /**
     * 考勤等级：0-3
     */
    private int attendanceLevel;

    /**
     * 是否具备晋升资格
     */
    private boolean promotionEligible;

    /**
     * 是否进入绩效改进计划
     */
    private boolean needPip;

    /**
     * 说明与建议
     */
    private List<String> remarks = new ArrayList<String>();

    public void addRemark(String remark) {
        this.remarks.add(remark);
    }
}

PerformanceRules.java

package com.github.paohaijiao.demo;

import com.github.paohaijiao.xml.param.Param;

/**
 * 场景 6（生产级样板）：绩效等级与奖金系数规则集
 * <p>
 * 规则按「加权评分 → 等级映射 → 系数修正 → 奖金核算」拆分：
 * <ul>
 *     <li>评分类：KPI / 项目 / 协作 / 考勤四维加权</li>
 *     <li>修正类：管理者加成、销售激励、违规扣减</li>
 *     <li>决策类：晋升资格、绩效改进、奖金金额</li>
 * </ul>
 * 规则脚本见 {@code src/test/resources/demo/performance.xml}。
 */
public interface PerformanceRules {

    /**
     * 加权总分：KPI 50% + 项目 20% + 协作 15% + 考勤 15%
     */
    double weightedScore(@Param("kpiScore") double kpiScore,
                         @Param("projectScore") double projectScore,
                         @Param("teamScore") double teamScore,
                         @Param("attendanceScore") double attendanceScore);

    /**
     * 绩效等级：S / A / B / C / D
     */
    String grade(@Param("totalScore") double totalScore);

    /**
     * 等级基准奖金系数
     */
    double baseCoefficient(@Param("grade") String grade);

    /**
     * 管理者加成
     */
    double managerBonus(@Param("manager") boolean manager);

    /**
     * 销售激励：高等级高销售额额外加成
     */
    double salesBonus(@Param("salesAmount") double salesAmount,
                      @Param("grade") String grade);

    /**
     * 违规扣减
     */
    double violationPenalty(@Param("hasViolation") boolean hasViolation);

    /**
     * 是否具备晋升资格
     */
    boolean promotionEligible(@Param("totalScore") double totalScore,
                              @Param("hasViolation") boolean hasViolation);

    /**
     * 是否进入绩效改进计划
     */
    boolean needPip(@Param("totalScore") double totalScore,
                    @Param("hasViolation") boolean hasViolation);

    /**
     * 考勤等级：>=95 为 3，>=90 为 2，>=80 为 1，否则 0
     */
    int attendanceLevel(@Param("attendanceScore") double attendanceScore);

    /**
     * 奖金金额 = 基本工资 × 最终系数
     */
    double bonusAmount(@Param("baseSalary") double baseSalary,
                       @Param("bonusCoefficient") double bonusCoefficient);
}

ance.xml

class="header">

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE javas PUBLIC "-//PAOHAIJIAO//DTD API JAVA 1.0//EN"
        "classpath:paohaijiao/dtd/Jquick-java.dtd">
<javas namespace="com.github.paohaijiao.demo.PerformanceRules">
 <!-- 加权总分 -->
    <java name="weightedScore" returnClass="double">
        <![CDATA[
            double def weightedScore(double:kpiScore, double:projectScore, double:teamScore, double:attendanceScore) {
                double total = kpiScore * 0.5 + projectScore * 0.2 + teamScore * 0.15 + attendanceScore * 0.15;
                return total;
            }
        ]]>
    </java>
 <!-- 绩效等级 -->
    <java name="grade" returnClass="java.lang.String">
        <![CDATA[
            str def grade(double:totalScore) {
                if (totalScore >= 90.0) {
                    return "S";
                } else if (totalScore >= 80.0) {
                    return "A";
                } else if (totalScore >= 70.0) {
                    return "B";
                } else if (totalScore >= 60.0) {
                    return "C";
                } else {
                    return "D";
                }
            }
        ]]>
    </java>
 <!-- 等级基准系数 -->
    <java name="baseCoefficient" returnClass="double">
        <![CDATA[
            double def baseCoefficient(str:grade) {
                if (grade == "S") {
                    return 1.8;
                } else if (grade == "A") {
                    return 1.4;
                } else if (grade == "B") {
                    return 1.1;
                } else if (grade == "C") {
                    return 0.8;
                } else {
                    return 0.5;
                }
            }
        ]]>
    </java>
 <!-- 管理者加成 -->
    <java name="managerBonus" returnClass="double">
        <![CDATA[
            double def managerBonus(boolean:manager) {
                if (manager) {
                    return 0.2;
                } else {
                    return 0.0;
                }
            }
        ]]>
    </java>
 <!-- 销售激励 -->
    <java name="salesBonus" returnClass="double">
        <![CDATA[
            double def salesBonus(double:salesAmount, str:grade) {
                if ((grade == "S" || grade == "A") && salesAmount >= 500000.0) {
                    return 0.2;
                } else if (salesAmount >= 200000.0) {
                    return 0.1;
                } else {
                    return 0.0;
                }
            }
        ]]>
    </java>
 <!-- 违规扣减 -->
    <java name="violationPenalty" returnClass="double">
        <![CDATA[
            double def violationPenalty(boolean:hasViolation) {
                if (hasViolation) {
                    return -0.3;
                } else {
                    return 0.0;
                }
            }
        ]]>
    </java>
 <!-- 晋升资格 -->
    <java name="promotionEligible" returnClass="boolean">
        <![CDATA[
            boolean def promotionEligible(double:totalScore, boolean:hasViolation) {
                if (hasViolation) {
                    return false;
                } else if (totalScore >= 85.0) {
                    return true;
                } else {
                    return false;
                }
            }
        ]]>
    </java>
 <!-- 绩效改进 -->
    <java name="needPip" returnClass="boolean">
        <![CDATA[
            boolean def needPip(double:totalScore, boolean:hasViolation) {
                if (totalScore < 60.0) {
                    return true;
                } else if (totalScore < 70.0 && hasViolation) {
                    return true;
                } else {
                    return false;
                }
            }
        ]]>
    </java>
 <!-- 考勤等级 -->
    <java name="attendanceLevel" returnClass="int">
        <![CDATA[
            int def attendanceLevel(double:attendanceScore) {
                if (attendanceScore >= 95.0) {
                    return 3;
                } else if (attendanceScore >= 90.0) {
                    return 2;
                } else if (attendanceScore >= 80.0) {
                    return 1;
                } else {
                    return 0;
                }
            }
        ]]>
    </java>
 <!-- 奖金金额 -->
    <java name="bonusAmount" returnClass="double">
        <![CDATA[
            double def bonusAmount(double:baseSalary, double:bonusCoefficient) {
                return baseSalary * bonusCoefficient;
            }
        ]]>
    </java>
 style="--0:#7FDBCA"></javas>

>PerformanceService.java