案例 8：税务合规风险打分

本案例对应 JQuick-Java 仓库 USE-CASES.md 的场景 8：税务合规风险打分，属于财税合规领域，解决按申报所属期对企业做「六维风险指标独立打分 → 风险分级 → 稽查处置路由 → 命中指标清单」的纳税合规评估问题。

行业场景

税务机关或财税 SaaS 平台需要按税款所属期对企业进行批量纳税合规评估。企业税务画像包含：逾期申报次数、缺失发票次数、实际税负率与行业平均税负率、本期营业收入、进项占比、是否存在异常发票、注册年限以及纳税信用等级（A/B/M/C/D）等字段。

评估从六个维度独立打分：逾期申报每次 5 分、单项封顶 25 分；缺失发票每次 8 分、单项封顶 24 分；税负率低于行业均值一半得 20 分、低于八成得 12 分；进项占比超过 0.95 得 15 分、超过 0.85 得 8 分；存在异常发票一票记 20 分；成立不足 1 年得 10 分、不足 3 年得 5 分。六维汇总后按 70/40 两条线映射 HIGH/MEDIUM/LOW。

处置路由分为三路：存在异常发票或总分达到 70 分的，直接进入税务稽查（TAX_AUDIT）并立案调查；40 分以上的安排实地走访（FIELD_VISIT）；其余企业常规自查（SELF_CHECK）。异常发票是独立于总分的「一票路由」——即使总分只有 20 分、等级 LOW，也照样移交稽查。

决策结果同时输出 7 条逐项指标清单（六个维度得分加风险总分）与关注备注（如「税负率显著低于行业均值，关注收入完整性」「进项占比过高，关注虚增进项风险」「新设企业，处于重点监控期」），支撑风险说明、约谈与事后审计回溯。场景 8 覆盖 6 组企业形态：多维全中的高风险企业（100 分）、合规良好企业（0 分自查）、中风险 48 分实地走访、异常发票单独触发稽查、进项异常 32 分、新设企业 72 分。

业务痛点

六个维度的扣分口径（每次 5 分/8 分、封顶 25/24、0.5/0.8 倍行业均值、0.95/0.85 进项占比）散落在风控脚本与报表逻辑中，各分局或行业调整阈值都要改代码发版。
税负率与行业均值比较若写成除法形式，既存在浮点精度问题又要防行业均值为零；硬编码时各处写法不一。
六个维度分数叠加可能超过 100，分级阈值（70/40）与处置路由需要统一收口，否则不同入口算出的等级不一致。
「异常发票一票稽查」与「按总分分级」是两条决策路径，写成普通 if-else 时容易退化为「必须高分才稽查」，放过低分高危企业。
企业对评定结果有异议时，需要逐维度的得分明细作为解释材料，黑盒总分无法满足税务审计的可回溯要求。
税务系统变更审批严格、发布窗口少，且大量配套系统运行在 JDK 8 与信创环境，需要轻量、可热更新、无重型中间件的规则方案。

方案架构

本案例采用标准「六件套」：入参模型承载企业申报与经营快照，决策结果模型承载分数、等级、路由与指标清单，规则接口声明 10 个规则方法，XML 脚本外置全部扣分口径与阈值，Service 负责六维汇总、0-100 封顶与清单组装，JUnit 以 6 组企业形态回归。

层次	职责	对应文件
领域模型	企业税务画像、税务风险决策结果	TaxProfile.java、TaxRiskDecision.java
规则集与 XML	六维评分 + 风险等级 + 稽查/预警/立案路由共 10 个方法	TaxComplianceRules.java、tax-compliance.xml
编排服务	六维汇总并 clamp 到 0-100、7 条指标清单与关注备注组装	TaxComplianceService.java
测试	6 组企业形态（高风险/合规/中风险/异常发票/进项异常/新设）	TaxComplianceServiceTest.java

规则方法拆分

规则方法	口径	分值/输出
`scoreLate`	逾期申报每次 5 分，单项封顶 25	0-25
`scoreMissingInvoice`	缺失发票每次 8 分，单项封顶 24	0-24
`scoreBurden`	税负率低于行业均值×0.5 得 20、低于×0.8 得 12（交叉相乘比较，不用除法）	0/12/20
`scoreInputRatio`	进项占比超过 0.95 得 15、超过 0.85 得 8	0/8/15
`scoreAbnormal`	存在异常发票一票记 20 分	0/20
`scoreAge`	成立不足 1 年得 10、不足 3 年得 5	0/5/10
`riskLevel`	≥70 HIGH / ≥40 MEDIUM / 否则 LOW	HIGH/MEDIUM/LOW
`auditLevel`	异常发票或 ≥70 → TAX_AUDIT；≥40 → FIELD_VISIT；否则 SELF_CHECK	TAX_AUDIT/FIELD_VISIT/SELF_CHECK
`needWarning`	总分 ≥40 推送风险提醒	true / false
`needInvestigation`	总分 ≥70 或存在异常发票 → 立案调查	true / false

代码实现（完整可运行）

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

TaxProfile.java

package com.github.paohaijiao.demo.model;

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

/**
 * 企业税务画像（税务风险打分所需的申报与经营快照）
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
public class TaxProfile {

    /**
     * 企业税号
     */
    private String companyId;

    /**
     * 企业名称
     */
    private String companyName;

    /**
     * 纳税人类型：GENERAL-一般纳税人 / SMALL_MICRO-小规模
     */
    private String taxpayerType;

    /**
     * 申报所属期
     */
    private String taxPeriod;

    /**
     * 逾期申报次数
     */
    private int lateCount;

    /**
     * 缺失发票次数
     */
    private int missingInvoice;

    /**
     * 实际税负率
     */
    private double taxBurdenRate;

    /**
     * 行业平均税负率
     */
    private double industryAvgBurden;

    /**
     * 本期营业收入（元）
     */
    private double revenue;

    /**
     * 进项占比
     */
    private double inputTaxRatio;

    /**
     * 是否存在异常发票
     */
    private boolean hasAbnormalInvoice;

    /**
     * 注册年限
     */
    private int yearsSinceRegister;

    /**
     * 纳税信用等级：A / B / M / C / D
     */
    private String creditRating;
}

TaxRiskDecision.java

package com.github.paohaijiao.demo.model;

import lombok.Data;

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

/**
 * 税务合规风险决策结果
 */
@Data
public class TaxRiskDecision {

    /**
     * 企业税号
     */
    private String companyId;

    /**
     * 风险总分（0-100）
     */
    private int riskScore;

    /**
     * 风险等级：HIGH / MEDIUM / LOW
     */
    private String riskLevel;

    /**
     * 处置方式：SELF_CHECK-自查 / FIELD_VISIT-实地核查 / TAX_AUDIT-税务稽查
     */
    private String auditLevel;

    /**
     * 是否推送风险提醒
     */
    private boolean needWarning;

    /**
     * 是否移交稽查
     */
    private boolean needInvestigation;

    /**
     * 风险指标明细
     */
    private List<String> indicators = new ArrayList<String>();

    /**
     * 处置建议
     */
    private List<String> notes = new ArrayList<String>();

    public void addIndicator(String indicator) {
        this.indicators.add(indicator);
    }

    public void addNote(String note) {
        this.notes.add(note);
    }
}

TaxComplianceRules.java

package com.github.paohaijiao.demo;

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

/**
 * 场景 8（生产级样板）：税务合规风险打分规则集
 * <p>
 * 规则按「多维风险指标 → 分级 → 处置路由」拆分，六个维度独立计分：
 * 逾期申报、缺失发票、税负率异常、进项异常、异常发票、成立年限。
 * 规则脚本见 {@code src/test/resources/demo/tax-compliance.xml}。
 */
public interface TaxComplianceRules {

    /**
     * 逾期申报扣分（每次 5 分，封顶 25）
     */
    int scoreLate(@Param("lateCount") int lateCount);

    /**
     * 缺失发票扣分（每次 8 分，封顶 24）
     */
    int scoreMissingInvoice(@Param("missingInvoice") int missingInvoice);

    /**
     * 税负率异常扣分：明显低于行业均值触发
     */
    int scoreBurden(@Param("taxBurdenRate") double taxBurdenRate,
                    @Param("industryAvgBurden") double industryAvgBurden);

    /**
     * 进项占比异常扣分
     */
    int scoreInputRatio(@Param("inputTaxRatio") double inputTaxRatio);

    /**
     * 异常发票扣分
     */
    int scoreAbnormal(@Param("hasAbnormalInvoice") boolean hasAbnormalInvoice);

    /**
     * 新设企业扣分（成立时间越短风险越高）
     */
    int scoreAge(@Param("yearsSinceRegister") int yearsSinceRegister);

    /**
     * 风险等级：HIGH / MEDIUM / LOW
     */
    String riskLevel(@Param("riskScore") int riskScore);

    /**
     * 处置方式：SELF_CHECK / FIELD_VISIT / TAX_AUDIT
     */
    String auditLevel(@Param("riskScore") int riskScore,
                      @Param("hasAbnormalInvoice") boolean hasAbnormalInvoice);

    /**
     * 是否推送风险提醒
     */
    boolean needWarning(@Param("riskScore") int riskScore);

    /**
     * 是否移交稽查
     */
    boolean needInvestigation(@Param("riskScore") int riskScore,
                              @Param("hasAbnormalInvoice") boolean hasAbnormalInvoice);
}

compliance.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.TaxComplianceRules">
 <!-- 逾期申报扣分 -->
    <java name="scoreLate" returnClass="int">
        <![CDATA[
            int def scoreLate(int:lateCount) {
                int score = lateCount * 5;
                if (score > 25) {
                    score = 25;
                }
                return score;
            }
        ]]>
    </java>
 <!-- 缺失发票扣分 -->
    <java name="scoreMissingInvoice" returnClass="int">
        <![CDATA[
            int def scoreMissingInvoice(int:missingInvoice) {
                int score = missingInvoice * 8;
                if (score > 24) {
                    score = 24;
                }
                return score;
            }
        ]]>
    </java>
 <!-- 税负率异常扣分 -->
    <java name="scoreBurden" returnClass="int">
        <![CDATA[
            int def scoreBurden(double:taxBurdenRate, double:industryAvgBurden) {
                if (taxBurdenRate < industryAvgBurden * 0.5) {
                    return 20;
                } else if (taxBurdenRate < industryAvgBurden * 0.8) {
                    return 12;
                } else {
                    return 0;
                }
            }
        ]]>
    </java>
 <!-- 进项占比异常扣分 -->
    <java name="scoreInputRatio" returnClass="int">
        <![CDATA[
            int def scoreInputRatio(double:inputTaxRatio) {
                if (inputTaxRatio > 0.95) {
                    return 15;
                } else if (inputTaxRatio > 0.85) {
                    return 8;
                } else {
                    return 0;
                }
            }
        ]]>
    </java>
 <!-- 异常发票扣分 -->
    <java name="scoreAbnormal" returnClass="int">
        <![CDATA[
            int def scoreAbnormal(boolean:hasAbnormalInvoice) {
                if (hasAbnormalInvoice) {
                    return 20;
                } else {
                    return 0;
                }
            }
        ]]>
    </java>
 <!-- 新设企业扣分 -->
    <java name="scoreAge" returnClass="int">
        <![CDATA[
            int def scoreAge(int:yearsSinceRegister) {
                if (yearsSinceRegister < 1) {
                    return 10;
                } else if (yearsSinceRegister < 3) {
                    return 5;
                } else {
                    return 0;
                }
            }
        ]]>
    </java>
 <!-- 风险等级 -->
    <java name="riskLevel" returnClass="java.lang.String">
        <![CDATA[
            str def riskLevel(int:riskScore) {
                if (riskScore >= 70) {
                    return "HIGH";
                } else if (riskScore >= 40) {
                    return "MEDIUM";
                } else {
                    return "LOW";
                }
            }
        ]]>
    </java>
 <!-- 处置方式 -->
    <java name="auditLevel" returnClass="java.lang.String">
        <![CDATA[
            str def auditLevel(int:riskScore, boolean:hasAbnormalInvoice) {
                if (hasAbnormalInvoice) {
                    return "TAX_AUDIT";
                } else if (riskScore >= 70) {
                    return "TAX_AUDIT";
                } else if (riskScore >= 40) {
                    return "FIELD_VISIT";
                } else {
                    return "SELF_CHECK";
                }
            }
        ]]>
    </java>
 <!-- 是否推送提醒 -->
    <java name="needWarning" returnClass="boolean">
        <![CDATA[
            boolean def needWarning(int:riskScore) {
                if (riskScore >= 40) {
                    return true;
                } else {
                    return false;
                }
            }
        ]]>
    </java>
 <!-- 是否移交稽查 -->
    <java name="needInvestigation" returnClass="boolean">
        <![CDATA[
            boolean def needInvestigation(int:riskScore, boolean:hasAbnormalInvoice) {
                if (hasAbnormalInvoice) {
                    return true;
                } else if (riskScore >= 70) {
                    return true;
                } else {
                    return false;
                }
            }
        ]]>
    </java>
 style="--0:#7FDBCA"></javas>

a">TaxComplianceService.java