:feat: HCS操作人登录名配置化统一取值，模板映射改括号记法修复中文键绑定失败

2026-10-12 17:36:57 +08:00
parent dc6d7bbc3f
commit b7293c0ddb
8 changed files with 35 additions and 47 deletions
@@ -61,6 +61,21 @@ public class HcsProperties {
 	 * 来源系统标识（fd_sources，D14 约定值 TMS）
 	 */
 	private String srcSystem = "WLTMS";
+	/**
+	 * 操作人登录名（fdLoginName / curUser.fdLoginName，全部合同接口共用，§9-U2）
+	 */
+	private String operatorLoginName = "srvadmin";
+	/**
+	 * Mock 开关（thirdParty.hcs.mockEnabled）：true 时 IHcsClient 切换为本地 JSON 桩
+	 * （{mockDir}/{方法名}.json，见 {@link org.springblade.hcs.mock.HcsClientMock}），
+	 * 供联调前本地自测；生产环境必须为 false
+	 */
+	private boolean mockEnabled = false;
+	/**
+	 * Mock 桩文件目录（与 mockEnabled 配套）：存放各接口出参桩 {方法名}.json（源自 HCS 接口文档出参示例），
+	 * 每次调用现读，改文件即生效；默认本机开发目录，其他环境经 Nacos 按需覆盖
+	 */
+	private String mockDir = "F:/home/tms/mock/hcs";
 	/**
 	 * 创建单位 fdId（HCS 组织主数据固定值，fd_creator_unit 等组织引用，各合同接口共用）
 	 */
@@ -161,10 +176,6 @@ public class HcsProperties {
 		 * TMS 合同类别 -> HCS 模板ID（fdTemplateId，§9-U7 待合规方提供模板清单）
 		 */
 		private Map<String, String> templateMapping = new HashMap<>();
-		/**
-		 * TMS 结算方式 -> 付款|收款（fdSettlementType，§9-U3 字典映射待联调）
-		 */
-		private Map<String, String> settlementTypeMapping = new HashMap<>();
 		/**
 		 * TMS 审核状态 -> HCS 合同状态（xformFields CONTRACT_STATUS 必填，draft/approving/approved 等，§9-U3 待联调后配置）
 		 */
@@ -301,7 +301,7 @@ public class HcsContractDetailVO implements Serializable {
 	 */
 	private Boolean fdSepcailContract;
 	/**
-	 * 合同结算模式：open=开口合同; close=闭口合同
+	 * 合同结算模式：open=开口合同; close=闭口合同。开口合同指合同签订时不明确约定总金额、总数量、具体收付款日期，按实际发生的供货量、业务量结算的合同
 	 */
 	private String fdContractGwNature;
 	/**