案例 24：行业许可证年审合规校验

本案例对应 USE-CASES 场景 24「行业许可证年审合规校验（诉求 23）」，属于政务监管领域，以食品经营许可证年审为样板，面向市场监管部门对持证经营主体的年度合规审查，自动完成八个维度正向计分、通过/附条件/不予通过分档，并对证照失效与重大违法违规执行红线驳回。

行业场景

食品经营主体每年须报送许可证年审材料，申报要素覆盖经营资质与日常合规两类：许可证是否在有效期内、营业执照是否有效、健康证过期人数与应持健康证总人数、食品安全培训覆盖率、是否按规定配备食品安全员、日常监督检查一般不符合项数、上年度不符合项是否完成整改、年内有效消费投诉件数、环境卫生量化等级（A/B/C）、是否投保食品安全责任险、年度重大违法违规次数。

年审采用八个维度正向计分、满分 100：健康证管理 20 分（零过期满分，过期比例低于 10% 得 12 分、低于 30% 得 6 分）、食安培训 15 分（覆盖率 100%/80%/60% 对应 15/12/8，其余 2 分）、食安员配备 10 分、检查缺陷项 15 分（0/≤2/≤5 项对应 15/10/5）、问题整改 10 分、投诉处置 10 分（0/≤3/≤10 件对应 10/6/2）、环境卫生 10 分（A/B/C 对应 10/6/0）、食安责任险 10 分（未投保仍得 5 分基础分）。

审查结论分四档：总分 ≥85 的 PASS 通过，≥70 的 CONDITIONAL 附条件通过，其余 FAIL 不予通过；此外单设 REJECT 红线驳回档，三条红线不进入计分直接驳回：许可证超过有效期、营业执照失效或被吊销、年度内存在重大食品安全违法违规记录。附条件与不予通过的主体还会收到逐项不合规告知，包括健康证过期调离、培训补训补考、配备食安员、缺陷项整改、整改闭环、投诉处置、C 级停业整顿、建议投保责任险等。

决策结果携带合规总分、九个维度的得分明细（含各维度满分分母与合规总分行）以及不合规项与整改要求清单，直接生成年审结论书与限期整改通知；PASS 主体不再罗列不合规项。健康证应持总人数为 0（台账缺失）时，Java 侧直接判 0 分并在不合规项中要求限期补建台账，不调用比率规则，从源头规避除零问题。

业务痛点

评分口径随年审细则逐年调参：各维度档位分值、85/70 分档线、培训覆盖率与投诉件数门槛每年都可能修订，硬编码进监管系统后调整成本高。
比率维度用整数运算易出错：健康证过期比例 10%/30% 的判断若写成整数除法会直接截断为 0，导致大面积过期仍拿满分。
红线必须先于评分驳回：证照失效、重大违规的主体不能因为其他维度满分而通过年审，红线短路顺序是合规底线。
除零与台账缺失场景要兜底：应持健康证总人数为 0 时不能直接算比率，须单独识别为「未建立台账」并给 0 分。
整改意见必须逐项对应失分项：附条件与不予通过门店需要拿到具体的人员调离、补训、整改、投保等告知，笼统结论无法支撑基层执法。
基层监管环境信创与存量 JDK 8 约束：年审系统多为存量政务应用，不能为评分能力引入重型独立平台。

方案架构

本案例沿用六件套骨架：入参模型 + 决策结果模型 + 规则接口 + XML 规则脚本 + Service 编排 + 6 组真实业务形态测试。

层次	职责	对应文件
领域模型	许可证年审申报要素、年审决策结果（结论/总分/得分明细/不合规项）	LicenseReviewApplication.java、LicenseReviewDecision.java
规则集与 XML	八维计分口径、健康证比率分档、85/70 结论线	LicenseAnnualReviewRules.java、license-annual-review.xml
编排服务	三条红线前置驳回、除零保护、八维汇总、不合规项逐项告知	LicenseAnnualReviewService.java
测试	6 组主体形态（满分通过/轻微附条件/严重不予通过/重大违规/证照失效/85 分临界）	LicenseAnnualReviewServiceTest.java

规则方法拆分

规则方法	口径	分值/输出
`scoreHealth`	零过期 20；过期比例低于 10%（expired×10 小于 total）12；低于 30%（expired×10 小于 total×3）6；否则 0	0-20
`scoreTraining`	覆盖率 ≥100% 得 15、≥80% 得 12、≥60% 得 8，否则 2	2-15
`scoreOfficer`	已配备食品安全员 10，否则 0	0/10
`scoreDefects`	缺陷 0 项 15、≤2 项 10、≤5 项 5，否则 0	0-15
`scoreRectification`	上年度不符合项已完成整改 10，否则 0	0/10
`scoreComplaints`	投诉 0 件 10、≤3 件 6、≤10 件 2，否则 0	0-10
`scoreEnvironment`	环境量化等级 A 10、B 6、其余（含 C）0	0-10
`scoreInsurance`	已投保食安责任险 10，未投保保留 5 分基础分	5/10
`reviewLevel`	总分 ≥85 PASS、≥70 CONDITIONAL、否则 FAIL	三种结论

代码实现（完整可运行）

将下列文件按源码包结构放入 JQuick-Java 工程的测试目录：两个模型放入 src/test/java/com/github/paohaijiao/demo/model/，规则接口与测试类放入 src/test/java/com/github/paohaijiao/demo/，Service 放入 src/test/java/com/github/paohaijiao/demo/service/，XML 脚本放入 src/test/resources/demo/，包名保持源码原样（com.github.paohaijiao.demo / .model / .service）。放入后执行 mvn test -Dtest=LicenseAnnualReviewServiceTest 即可运行全部 6 个用例。

LicenseReviewApplication.java

package com.github.paohaijiao.demo.model;

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

/**
 * 食品经营许可证年审申报要素
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
public class LicenseReviewApplication {

    /**
     * 许可证编号
     */
    private String licenseId;

    /**
     * 经营主体名称
     */
    private String enterpriseName;

    /**
     * 许可证是否在有效期内
     */
    private boolean validWithinPeriod;

    /**
     * 营业执照是否有效
     */
    private boolean businessLicenseValid;

    /**
     * 健康证过期人数
     */
    private int healthCertificateExpired;

    /**
     * 应持健康证总人数
     */
    private int healthCertificateTotal;

    /**
     * 食品安全培训覆盖率（整数百分比）
     */
    private int trainingRate;

    /**
     * 是否按规定配备食品安全员
     */
    private boolean foodSafetyOfficer;

    /**
     * 日常监督检查一般不符合项数
     */
    private int defectCount;

    /**
     * 上年度不符合项是否完成整改
     */
    private boolean rectificationCompleted;

    /**
     * 年内有效消费投诉件数
     */
    private int complaintCount;

    /**
     * 环境卫生量化等级：A / B / C
     */
    private String environmentalRating;

    /**
     * 是否投保食品安全责任险
     */
    private boolean liabilityInsurance;

    /**
     * 年度重大违法违规次数
     */
    private int majorViolationCount;
}

LicenseReviewDecision.java

package com.github.paohaijiao.demo.model;

import lombok.Data;

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

/**
 * 许可证年审合规决策结果
 */
@Data
public class LicenseReviewDecision {

    /**
     * 许可证编号
     */
    private String licenseId;

    /**
     * 年审结论：PASS-通过 / CONDITIONAL-附条件通过 / FAIL-不予通过 / REJECT-红线驳回
     */
    private String result;

    /**
     * 合规评分（0-100）
     */
    private int totalScore;

    /**
     * 各维度得分明细
     */
    private List<String> scoreDetails = new ArrayList<String>();

    /**
     * 不合规项与整改要求
     */
    private List<String> nonConformities = new ArrayList<String>();

    public void addScoreDetail(String detail) {
        this.scoreDetails.add(detail);
    }

    public void addNonConformity(String nonConformity) {
        this.nonConformities.add(nonConformity);
    }
}

LicenseAnnualReviewRules.java

package com.github.paohaijiao.demo;

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

/**
 * 场景 24：行业许可证（食品经营）年审合规评分规则集
 * <p>
 * 八个维度正向计分，满分 100：健康证 20 / 培训 15 / 食安员 10 / 缺陷项 15
 * / 整改 10 / 投诉 10 / 环境等级 10 / 责任险 10；85 通过、70 附条件。
 * 规则脚本见 {@code src/test/resources/demo/license-annual-review.xml}。
 */
public interface LicenseAnnualReviewRules {

    /** 健康证合规得分：零过期满分，过期比例 10%/30% 两段，交叉相乘避免整数除法 */
    int scoreHealth(@Param("expired") int expired,
                    @Param("total") int total);

    /** 食安培训覆盖率得分：100% 满分，80%/60% 两段 */
    int scoreTraining(@Param("rate") int rate);

    /** 是否配备食品安全员 */
    int scoreOfficer(@Param("hasOfficer") boolean hasOfficer);

    /** 日常检查缺陷项得分：0 项满分，2 项/5 项两段 */
    int scoreDefects(@Param("defectCount") int defectCount);

    /** 上年度问题整改完成情况 */
    int scoreRectification(@Param("completed") boolean completed);

    /** 有效投诉得分：0 件满分，3 件/10 件两段 */
    int scoreComplaints(@Param("complaintCount") int complaintCount);

    /** 环境卫生量化等级得分 */
    int scoreEnvironment(@Param("rating") String rating);

    /** 食品安全责任险投保情况（未投保仍得基础分 5） */
    int scoreInsurance(@Param("hasInsurance") boolean hasInsurance);

    /** 年审结论：85 分通过，70 分附条件，其余不予通过 */
    String reviewLevel(@Param("totalScore") int totalScore);
}

运行
在工程根目录执行： 15 / 食安员 10 / 缺陷项 15 * / 整改 10 / 投诉 10 / 环境等级 10 / 责任险 10；85 通过、70 附条件。 * 规则脚本见 {@code src/test/resources/demo/license-annual-review.xml}。 */public interface LicenseAnnualReviewRules { /** 健康证合规得分：零过期满分，过期比例 10%/30% 两段，交叉相乘避免整数除法 */ int scoreHealth(@Param("expired") int expired, @Param("total") int total); /** 食安培训覆盖率得分：100% 满分，80%/60% 两段 */ int scoreTraining(@Param("rate") int rate); /** 是否配备食品安全员 */ int scoreOfficer(@Param("hasOfficer") boolean hasOfficer); /** 日常检查缺陷项得分：0 项满分，2 项/5 项两段 */ int scoreDefects(@Param("defectCount") int defectCount); /** 上年度问题整改完成情况 */ int scoreRectification(@Param("completed") boolean completed); /** 有效投诉得分：0 件满分，3 件/10 件两段 */ int scoreComplaints(@Param("complaintCount") int complaintCount); /** 环境卫生量化等级得分 */ int scoreEnvironment(@Param("rating") String rating); /** 食品安全责任险投保情况（未投保仍得基础分 5） */ int scoreInsurance(@Param("hasInsurance") boolean hasInsurance); /** 年审结论：85 分通过，70 分附条件，其余不予通过 */ String reviewLevel(@Param("totalScore") int totalScore);}">

l">license-annual-review.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.LicenseAnnualReviewRules">
 <!-- 健康证：expired/total 比率用交叉相乘（expired*10 对 total、total*3） -->
    <java name="scoreHealth" returnClass="int">
        <![CDATA[
            int def scoreHealth(int:expired, int:total) {
                if (expired == 0) {
                    return 20;
                } else if (expired * 10 < total) {
                    return 12;
                } else if (expired * 10 < total * 3) {
                    return 6;
                } else {
                    return 0;
                }
            }
        ]]>
    </java>
 <!-- 培训覆盖率 -->
    <java name="scoreTraining" returnClass="int">
        <![CDATA[
            int def scoreTraining(int:rate) {
                if (rate >= 100) {
                    return 15;
                } else if (rate >= 80) {
                    return 12;
                } else if (rate >= 60) {
                    return 8;
                } else {
                    return 2;
                }
            }
        ]]>
    </java>
 <!-- 食品安全员配备 -->
    <java name="scoreOfficer" returnClass="int">
        <![CDATA[
            int def scoreOfficer(boolean:hasOfficer) {
                if (hasOfficer) {
                    return 10;
                } else {
                    return 0;
                }
            }
        ]]>
    </java>
 <!-- 日常检查缺陷项 -->
    <java name="scoreDefects" returnClass="int">
        <![CDATA[
            int def scoreDefects(int:defectCount) {
                if (defectCount == 0) {
                    return 15;
                } else if (defectCount <= 2) {
                    return 10;
                } else if (defectCount <= 5) {
                    return 5;
                } else {
                    return 0;
                }
            }
        ]]>
    </java>
 <!-- 上年度整改 -->
    <java name="scoreRectification" returnClass="int">
        <![CDATA[
            int def scoreRectification(boolean:completed) {
                if (completed) {
                    return 10;
                } else {
                    return 0;
                }
            }
        ]]>
    </java>
 <!-- 有效投诉 -->
    <java name="scoreComplaints" returnClass="int">
        <![CDATA[
            int def scoreComplaints(int:complaintCount) {
                if (complaintCount == 0) {
                    return 10;
                } else if (complaintCount <= 3) {
                    return 6;
                } else if (complaintCount <= 10) {
                    return 2;
                } else {
                    return 0;
                }
            }
        ]]>
    </java>
 <!-- 环境卫生量化等级 -->
    <java name="scoreEnvironment" returnClass="int">
        <![CDATA[
            int def scoreEnvironment(str:rating) {
                if (rating == "A") {
                    return 10;
                } else if (rating == "B") {
                    return 6;
                } else {
                    return 0;
                }
            }
        ]]>
    </java>
 <!-- 食安责任险 -->
    <java name="scoreInsurance" returnClass="int">
        <![CDATA[
            int def scoreInsurance(boolean:hasInsurance) {
                if (hasInsurance) {
                    return 10;
                } else {
                    return 5;
                }
            }
        ]]>
    </java>
 <!-- 年审结论分档 -->
    <java name="reviewLevel" returnClass="java.lang.String">
        <![CDATA[
            str def reviewLevel(int:totalScore) {
                if (totalScore >= 85) {
                    return "PASS";
                } else if (totalScore >= 70) {
                    return "CONDITIONAL";
                } else {
                    return "FAIL";
                }
            }
        ]]>
    </java>
 style="--0:#7FDBCA"></javas>

icejava">LicenseAnnualReviewService.java