From 4ef3e90d5d110be9542856c5ffda774581ca1155 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=88=98=E6=B3=89=E4=BD=B3?= <1107186916@qq.com>
Date: Fri, 30 Oct 2026 13:33:56 +0800
Subject: [PATCH] =?UTF-8?q?fix:=20=E5=AE=A2=E5=95=86=E9=BB=91=E5=90=8D?=
 =?UTF-8?q?=E5=8D=95=E5=8F=A3=E5=BE=84=E8=B0=83=E6=95=B4=E4=B8=BA=E4=BB=85?=
 =?UTF-8?q?=E9=87=91=E8=9D=B6=E9=BB=91=E5=90=8D=E5=8D=95=E5=91=BD=E4=B8=AD?=
 =?UTF-8?q?=EF=BC=88A801-5=EF=BC=89=EF=BC=8CC101-1=E9=BB=91=E5=90=8D?=
 =?UTF-8?q?=E5=8D=95=E7=8A=B6=E6=80=81=E4=B8=8D=E7=94=A8=E4=BA=8E=E5=B1=95?=
 =?UTF-8?q?=E7=A4=BA=E4=B8=8E=E7=AD=9B=E9=80=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../transport/mapper/CustomerArchiveMapper.xml   |  4 ++--
 .../service/impl/CustomerArchiveServiceImpl.java |  2 +-
 .../support/hcs/HcsCreditCheckSupport.java       | 16 ++++++++--------
 ...6-10-30-客商黑名单与风险等级业务说明（业务侧）.md |  8 +++++---
 ...6-10-30-客商黑名单与风险等级运维手册（运维侧）.md |  2 +-
 5 files changed, 17 insertions(+), 15 deletions(-)

diff --git a/blade-service/blade-transport/src/main/java/org/springblade/transport/mapper/CustomerArchiveMapper.xml b/blade-service/blade-transport/src/main/java/org/springblade/transport/mapper/CustomerArchiveMapper.xml
index a0038ecc..c3d3b11a 100644
--- a/blade-service/blade-transport/src/main/java/org/springblade/transport/mapper/CustomerArchiveMapper.xml
+++ b/blade-service/blade-transport/src/main/java/org/springblade/transport/mapper/CustomerArchiveMapper.xml
@@ -181,11 +181,11 @@
         <if test="customer.createTimeEnd != null">
             AND create_time &lt;= #{customer.createTimeEnd}
         </if>
-        <!-- 客商风险筛选：blacklist 按黑名单状态过滤；等级筛选与黑名单独立（黑名单客商也有等级，组合展示口径一致） -->
+        <!-- 客商风险筛选：blacklist 仅按金蝶黑名单（A801-5）命中过滤；等级筛选独立 -->
         <if test="customer.customerRisk != null and customer.customerRisk != ''">
             <choose>
                 <when test="customer.customerRisk == 'blacklist'">
-                    AND hcs_black_status = 'yes'
+                    AND (kingdee_black_category IS NOT NULL OR kingdee_black_reason IS NOT NULL)
                 </when>
                 <when test="customer.customerRisk == 'high'">
                     AND hcs_risk_level = '2'
diff --git a/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/CustomerArchiveServiceImpl.java b/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/CustomerArchiveServiceImpl.java
index 7c0994ac..10d92f1b 100644
--- a/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/CustomerArchiveServiceImpl.java
+++ b/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/CustomerArchiveServiceImpl.java
@@ -2158,7 +2158,7 @@ public class CustomerArchiveServiceImpl extends BaseServiceImpl<CustomerArchiveM
 		for (CustomerArchiveVO record : records) {
 			String customerName = Func.isEmpty(record.getFullName()) ? record.getCustomerCode() : record.getFullName();
 			record.setHcsRiskDetail(HcsCreditCheckSupport.buildRiskDetail(customerName,
-				"yes".equalsIgnoreCase(record.getHcsBlackStatus()), record.getHcsRiskLevel(),
+				record.getHcsRiskLevel(),
 				record.getKingdeeBlackCategory(), record.getKingdeeBlackReason()));
 		}
 	}
diff --git a/blade-service/blade-transport/src/main/java/org/springblade/transport/support/hcs/HcsCreditCheckSupport.java b/blade-service/blade-transport/src/main/java/org/springblade/transport/support/hcs/HcsCreditCheckSupport.java
index 4c74ac7c..e591917c 100644
--- a/blade-service/blade-transport/src/main/java/org/springblade/transport/support/hcs/HcsCreditCheckSupport.java
+++ b/blade-service/blade-transport/src/main/java/org/springblade/transport/support/hcs/HcsCreditCheckSupport.java
@@ -235,8 +235,8 @@ public class HcsCreditCheckSupport {
 			: this.queryBlacklistByCodes(List.of(creditCode.trim().toUpperCase())).get(creditCode.trim().toUpperCase());
 		String blackCategory = hit == null ? null
 			: (Func.isEmpty(hit.getAwrpCombofieldTitle()) ? hit.getAwrpCombofield() : hit.getAwrpCombofieldTitle());
-		riskVO.setRiskTip(buildRiskDetail(customerName, BLACK_STATUS_YES.equalsIgnoreCase(riskVO.getFdBlackStatus()),
-			riskVO.getFdRiskLevel(), blackCategory, hit == null ? null : hit.getAwrpTextareafield()));
+		riskVO.setRiskTip(buildRiskDetail(customerName, riskVO.getFdRiskLevel(),
+			blackCategory, hit == null ? null : hit.getAwrpTextareafield()));
 		try {
 			hcsContractCheckLogMapper.insert(this.buildRiskCheckLog(customerCode, riskVO, fetch.traceId()));
 		} catch (Exception exception) {
@@ -361,21 +361,21 @@ public class HcsCreditCheckSupport {
 	/**
 	 * 组装客商风险明细文案（后台统一组装、前端只展示；列表悬浮明细与表单实时提示共用本方法，口径一致），
 	 * 格式：【客商名称】：被列入外部黑名单（失信类别：xx）；{列入事由}；风险等级：xx，分段说明：
-	 * ① 黑名单段：合同系统黑名单（blackStatusYes）或金蝶黑名单命中（类别/事由任一非空）→「被列入外部黑名单」，
-	 * 失信类别（A801-5 awrp_combofield_title，缺失兜底 awrp_combofield）有值时括号展示区分禁止交易/风险警示类；
+	 * ① 黑名单段：**仅以金蝶黑名单（A801-5）命中为准**（失信类别/列入事由任一非空），
+	 * 失信类别（awrp_combofield_title，缺失兜底 awrp_combofield）有值时括号展示区分禁止交易/风险警示类；
+	 * 合同合规系统 C101-1 的黑名单状态（fdBlackStatus）不作为展示黑名单依据；
 	 * ② 列入事由：金蝶 A801-5 awrp_textareafield 真实明细，非空时追加；
-	 * ③ 等级段：C101-1 风险等级（risk_level 字典翻译，黑名单不转义、按实际等级展示），非空时追加
+	 * ③ 等级段：C101-1 风险等级（risk_level 字典翻译），非空时追加
 	 *
 	 * @param customerName 客商名称
-	 * @param blackStatusYes 合同系统黑名单状态（C101-1 fdBlackStatus=yes）
 	 * @param riskLevel C101-1 风险等级（0/1/2）
 	 * @param blackCategory 金蝶黑名单失信类别
 	 * @param blackReason 金蝶黑名单列入事由
 	 * @return 明细文案，无风险信息返回空字符串
 	 */
-	public static String buildRiskDetail(String customerName, boolean blackStatusYes, String riskLevel, String blackCategory, String blackReason) {
+	public static String buildRiskDetail(String customerName, String riskLevel, String blackCategory, String blackReason) {
 		List<String> parts = new ArrayList<>();
-		boolean blacklist = blackStatusYes || Func.isNotEmpty(blackCategory) || Func.isNotEmpty(blackReason);
+		boolean blacklist = Func.isNotEmpty(blackCategory) || Func.isNotEmpty(blackReason);
 		if (blacklist) {
 			parts.add(Func.isNotEmpty(blackCategory)
 				? "被列入外部黑名单（失信类别：" + blackCategory + "）"
diff --git a/doc/docs/业务流程/2026-10-30-客商黑名单与风险等级业务说明（业务侧）.md b/doc/docs/业务流程/2026-10-30-客商黑名单与风险等级业务说明（业务侧）.md
index e57af84c..33787616 100644
--- a/doc/docs/业务流程/2026-10-30-客商黑名单与风险等级业务说明（业务侧）.md
+++ b/doc/docs/业务流程/2026-10-30-客商黑名单与风险等级业务说明（业务侧）.md
@@ -17,7 +17,7 @@ TMS 从**两个外部系统**获取客商风险数据，每日自动更新到客
 
 | 名词 | 含义 |
 |---|---|
-| 黑名单 | 客商被列入外部（国资委）黑名单。金蝶分 **A 类（禁止交易类，不允许交易）** 和 **B 类（风险警示类，需关注）** |
+| 黑名单 | 客商被列入外部（国资委）黑名单，**以金蝶黑名单查询（A801-5）命中为准**，命中记录含失信类别与列入事由。金蝶分 **A 类（禁止交易类，不允许交易）** 和 **B 类（风险警示类，需关注）** |
 | 失信类别 | 黑名单的分类名称（如"禁止交易类"），来自金蝶黑名单记录 |
 | 列入事由 | 被列入黑名单的具体原因（如"涉贪污受贿裁判相关提及方（3年以上及其他）"），来自金蝶黑名单记录 |
 | 风险等级 | 合同合规系统对客商的风险评级：0=低风险、1=中风险、2=高风险 |
@@ -66,14 +66,16 @@ flowchart TD
 
 | 客商情况 | 显示 | 颜色 |
 |---|---|---|
-| 黑名单 + 风险等级（组合展示，等级在前） | 高风险、黑名单 / 中风险、黑名单 / 低风险、黑名单 | 红 |
-| 仅黑名单（无等级数据） | 黑名单 | 红 |
+| 金蝶黑名单命中 + 风险等级（组合展示，等级在前） | 高风险、黑名单 / 中风险、黑名单 / 低风险、黑名单 | 红 |
+| 金蝶黑名单命中（无等级数据） | 黑名单 | 红 |
 | 仅高风险 | 高风险 | 红 |
 | 中风险 | 中风险 | 黄 |
 | 低风险 | 低风险 | 绿 |
 | 内部组织客商 | 无风险（默认，不查询） | 绿 |
 | 尚未查询到数据 | - | — |
 
+> "黑名单"仅指**金蝶黑名单命中**；合同合规系统返回的黑名单状态字段不用于列表展示（仅在付款提交强制校验中使用）。
+
 - 红色标签（黑名单/高风险）**鼠标悬浮**可查看明细：失信类别、列入事由、风险等级。
 - 搜索栏新增**客商风险**下拉筛选：黑名单 / 高风险 / 中风险 / 低风险。
 - 数据为每日凌晨刷新结果，当天有变动的以次日刷新为准。
diff --git a/doc/docs/业务流程/2026-10-30-客商黑名单与风险等级运维手册（运维侧）.md b/doc/docs/业务流程/2026-10-30-客商黑名单与风险等级运维手册（运维侧）.md
index 6cee8b25..e39f9934 100644
--- a/doc/docs/业务流程/2026-10-30-客商黑名单与风险等级运维手册（运维侧）.md
+++ b/doc/docs/业务流程/2026-10-30-客商黑名单与风险等级运维手册（运维侧）.md
@@ -105,7 +105,7 @@
 唯一出口：`HcsCreditCheckSupport.buildRiskDetail(customerName, blackStatusYes, riskLevel, blackCategory, blackReason)`，
 格式：`【客商名称】：被列入外部黑名单（失信类别：xx）；{列入事由}；风险等级：xx`
 
-- 黑名单段：合同系统黑名单 **或** 金蝶命中（类别/事由任一非空）；
+- 黑名单段：**仅金蝶命中**（类别/事由任一非空）；C101-1 的 `hcs_black_status`（fdBlackStatus）不参与展示，仅付款提交强制校验使用；
 - 等级段：`risk_level` 字典翻译（`DictBizCache` 未命中兜底 `DictCache`）；
 - 列表（`hcs_risk_detail`，列表查询时组装不落库）与表单实时提示（`riskTip`）同口径。