changelog: 2026-03/19_1111 (5 changes, 1 breaking)

.swagger/hl-contract-service.json

@@ -730,6 +730,57 @@
         "x-order": "2147483647"
       }
     },
+    "/admin/contract/platforms": {
+      "get": {
+        "tags": [
+          "合同管理"
+        ],
+        "summary": "可用合同平台列表",
+        "description": "返回系统已对接的合同平台列表及可用状态。\n前端在合同配置页面据此展示可选平台（如12301/法大大/e签宝/腾讯电子签）\n\n【关联字典】\n- 返回字段 platformName → 字典：contract_platform（合同平台）",
+        "operationId": "listPlatformsUsingGET",
+        "produces": [
+          "*/*"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/统一响应结果«List«ContractPlatformInfo»»",
+              "originalRef": "统一响应结果«List«ContractPlatformInfo»»"
+            }
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Not Found"
+          }
+        },
+        "responsesObject": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/统一响应结果«List«ContractPlatformInfo»»",
+              "originalRef": "统一响应结果«List«ContractPlatformInfo»»"
+            }
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Not Found"
+          }
+        },
+        "deprecated": false,
+        "x-order": "2147483647"
+      }
+    },
     "/admin/contract/report": {
       "post": {
         "tags": [
@@ -1194,6 +1245,21 @@
     }
   },
   "definitions": {
+    "ContractPlatformInfo": {
+      "type": "object",
+      "properties": {
+        "available": {
+          "type": "boolean"
+        },
+        "displayName": {
+          "type": "string"
+        },
+        "platformName": {
+          "type": "string"
+        }
+      },
+      "title": "ContractPlatformInfo"
+    },
     "分页结果«合同信息»": {
       "type": "object",
       "properties": {
@@ -1331,6 +1397,11 @@
           "example": 2,
           "description": "付款方式: 1-现金 2-转账 3-在线"
         },
+        "platform": {
+          "type": "string",
+          "example": 12301,
+          "description": "合同平台（字典：contract_platform）: 12301-全国旅游监管平台, FADADA-法大大, ESIGN-e签宝, TENCENT_ESS-腾讯电子签。不传则根据模板自动确定"
+        },
         "returnDate": {
           "type": "string",
           "format": "date",
@@ -1904,6 +1975,11 @@
           "example": 2,
           "description": "付款方式: 1-现金 2-转账 3-在线"
         },
+        "platform": {
+          "type": "string",
+          "example": 12301,
+          "description": "合同平台（字典：contract_platform）: 12301-全国旅游监管平台, FADADA-法大大, ESIGN-e签宝, TENCENT_ESS-腾讯电子签"
+        },
         "returnDate": {
           "type": "string",
           "format": "date",
@@ -2038,6 +2114,31 @@
       },
       "title": "旅行社信息"
     },
+    "统一响应结果«List«ContractPlatformInfo»»": {
+      "type": "object",
+      "properties": {
+        "code": {
+          "type": "integer",
+          "format": "int32",
+          "example": 200,
+          "description": "状态码"
+        },
+        "data": {
+          "type": "array",
+          "description": "响应数据",
+          "items": {
+            "$ref": "#/definitions/ContractPlatformInfo",
+            "originalRef": "ContractPlatformInfo"
+          }
+        },
+        "message": {
+          "type": "string",
+          "example": "成功",
+          "description": "响应消息"
+        }
+      },
+      "title": "统一响应结果«List«ContractPlatformInfo»»"
+    },
     "统一响应结果«List«合同信息»»": {
       "type": "object",
       "properties": {

changelogs/2026-03/19_1111_sync.md

@@ -0,0 +1,38 @@
+# API 变更通知
+
+**更新时间**: 2026-03-19 11:11
+
+## ⚠️ Breaking Changes (1)
+
+> **前端必须处理的变更，不处理会导致功能异常**
+
+### 字典变更
+
+**字典项删除**
+
+| 字典 | 删除值 | 标签 |
+| --- | --- | --- |
+| `product_node_type`（行程节点类型） | ~~`DINING`~~ | 餐饮 |
+
+## ℹ️ 新增 (4)
+
+### 合同服务
+
+**新增接口**
+
+- 🆕 `GET /admin/contract/platforms`
+
+**新增字段**
+
+| 数据对象 | 新增字段 | 类型 |
+| --- | --- | --- |
+| `创建合同请求` | `platform` | `string` |
+| `报备合同请求（同步模式）` | `platform` | `string` |
+
+### 字典变更
+
+**新增字典项**
+
+| 字典 | 新增值 | 标签 |
+| --- | --- | --- |
+| `product_node_type`（行程节点类型） | `RESTAURANT` | 餐厅 |