feat: HCS立项与合同数据层（实体合规字段组/合同风险留痕字段/校验留痕表/transport接入hcs-api依赖）

2026-09-27 22:41:04 +08:00
parent a739211d6f
commit cc9e01cff4
8 changed files with 350 additions and 0 deletions
@@ -209,4 +209,33 @@ public class ContractManage extends TenantEntity {
 	@Schema(description = "备注")
 	private String remark;

+	@Schema(description = "合规系统单据ID（fdContractId）")
+	private String hcsFdId;
+
+	@Schema(description = "合规同步状态 unsynced/synced/failed")
+	private String hcsSyncStatus;
+
+	@Schema(description = "合规推送失败重试次数")
+	@TableField(insertStrategy = FieldStrategy.ALWAYS, updateStrategy = FieldStrategy.ALWAYS)
+	private Integer hcsRetryCount;
+
+	@Schema(description = "合规最近同步时间")
+	private LocalDateTime hcsSyncTime;
+
+	@Schema(description = "合规最近同步结果信息/失败原因")
+	@TableField(insertStrategy = FieldStrategy.ALWAYS, updateStrategy = FieldStrategy.ALWAYS)
+	private String hcsSyncMsg;
+
+	@Schema(description = "合规履约计划ID（C103-9 返回 fdExeplanId）")
+	private String hcsExeplanId;
+
+	@Schema(description = "合规客商风险等级（C101-1，甲方/乙方取高）")
+	private String hcsRiskLevel;
+
+	@Schema(description = "合规客商黑名单状态（C101-1，甲方/乙方取是）")
+	private String hcsBlackStatus;
+
+	@Schema(description = "合规风险校验时间")
+	private LocalDateTime hcsRiskTime;
+
 }
@@ -0,0 +1,79 @@
+/**
+ * BladeX Commercial License Agreement
+ * Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
+ * <p>
+ * Use of this software is governed by the Commercial License Agreement
+ * obtained after purchasing a license from BladeX.
+ * <p>
+ * 1. This software is for development use only under a valid license
+ * from BladeX.
+ * <p>
+ * 2. Redistribution of this software's source code to any third party
+ * without a commercial license is strictly prohibited.
+ * <p>
+ * 3. Licensees may copyright their own code but cannot use segments
+ * from this software for such purposes. Copyright of this software
+ * remains with BladeX.
+ * <p>
+ * Using this software signifies agreement to this License, and the software
+ * must not be used for illegal purposes.
+ * <p>
+ * THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
+ * not liable for any claims arising from secondary or illegal development.
+ * <p>
+ * Author: Chill Zhuang (bladejava@qq.com)
+ */
+package org.springblade.transport.pojo.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+import java.time.LocalDateTime;
+
+/**
+ * HCS 风险/额度校验留痕实体类（照 ops 日志惯例，仅插入不改）
+ *
+ * @author Chill
+ */
+@Data
+@TableName("blade_hcs_check_log")
+@Schema(description = "HCS 风险/额度校验留痕")
+public class HcsContractCheckLog implements Serializable {
+
+	@Serial
+	private static final long serialVersionUID = 1L;
+
+	@TableId(value = "id", type = IdType.ASSIGN_ID)
+	@Schema(description = "主键")
+	private Long id;
+
+	@Schema(description = "租户ID")
+	private String tenantId;
+
+	@Schema(description = "业务类型 project/contract/payment")
+	private String bizType;
+
+	@Schema(description = "业务单据ID")
+	private Long bizId;
+
+	@Schema(description = "校验类型 risk=客商风险/credit=额度")
+	private String checkType;
+
+	@Schema(description = "校验结果 pass=通过/fail=不通过/skip=跳过")
+	private String result;
+
+	@Schema(description = "校验说明")
+	private String msg;
+
+	@Schema(description = "合规系统链路追踪ID")
+	private String traceId;
+
+	@Schema(description = "创建时间")
+	private LocalDateTime createTime;
+
+}
@@ -198,4 +198,21 @@ public class ProjectApply extends TenantEntity {
 	@Schema(description = "作废原因")
 	private String voidReason;

+	@Schema(description = "合规系统单据ID（fdId）")
+	private String hcsFdId;
+
+	@Schema(description = "合规同步状态 unsynced/synced/failed")
+	private String hcsSyncStatus;
+
+	@Schema(description = "合规推送失败重试次数")
+	@TableField(insertStrategy = FieldStrategy.ALWAYS, updateStrategy = FieldStrategy.ALWAYS)
+	private Integer hcsRetryCount;
+
+	@Schema(description = "合规最近同步时间")
+	private LocalDateTime hcsSyncTime;
+
+	@Schema(description = "合规最近同步结果信息/失败原因")
+	@TableField(insertStrategy = FieldStrategy.ALWAYS, updateStrategy = FieldStrategy.ALWAYS)
+	private String hcsSyncMsg;
+
 }