changelog: 2026-03/18_1130 (6 changes, 0 breaking)

.swagger/hl-user-service.json

@@ -1709,6 +1709,64 @@
         "x-order": "2147483647"
       }
     },
+    "/admin/user/designers": {
+      "get": {
+        "tags": [
+          "管理员管理接口"
+        ],
+        "summary": "全部定制师（不分页）",
+        "description": "返回所有已上线的定制师列表，不分页。用于订单指派定制师、下拉选择等场景。\n返回定制师ID、姓名、头像、认证等级等基本信息。",
+        "operationId": "listAllDesignersUsingGET",
+        "produces": [
+          "*/*"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "originalRef": "统一响应结果«List«旅行设计师VO»»",
+              "$ref": "#/definitions/统一响应结果«List«旅行设计师VO»»"
+            }
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Not Found"
+          }
+        },
+        "responsesObject": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "originalRef": "统一响应结果«List«旅行设计师VO»»",
+              "$ref": "#/definitions/统一响应结果«List«旅行设计师VO»»"
+            }
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Authorization": [
+              "global"
+            ]
+          }
+        ],
+        "deprecated": false,
+        "x-order": "2147483647"
+      }
+    },
     "/admin/user/{adminId}": {
       "get": {
         "tags": [
@@ -6491,7 +6549,7 @@
           "菜单管理接口"
         ],
         "summary": "创建菜单",
-        "description": "创建新的菜单/目录/按钮。menuType取值：DIRECTORY=目录（含子菜单） MENU=页面菜单 BUTTON=操作按钮。目录和菜单需设置path路由路径，菜单还需设置component组件路径。按钮类型需设置permissionCode权限标识（如system:user:add）。需要SUPER_ADMIN角色。\n\n**关联字典**：\n- menu_type（菜单类型）：请求/返回字段menuType（DIRECTORY=目录, MENU=菜单, BUTTON=按钮）\n- common_status（通用状态）：返回字段status",
+        "description": "创建新的菜单/目录/按钮。menuType取值：D=目录（含子菜单） M=页面菜单 B=操作按钮。目录和菜单需设置path路由路径，菜单还需设置component组件路径。按钮类型需设置permissionCode权限标识（如system:user:add）。需要SUPER_ADMIN角色。\n\n**关联字典**：\n- menu_type（菜单类型）：请求/返回字段menuType（D=目录, M=菜单, B=按钮）\n- common_status（通用状态）：返回字段status",
         "operationId": "createMenuUsingPOST",
         "consumes": [
           "application/json"
@@ -6754,7 +6812,7 @@
           "菜单管理接口"
         ],
         "summary": "获取菜单详情",
-        "description": "获取指定菜单的详细信息，包括名称、路径、组件、图标、排序、权限标识等。\n\n**权限**：需要管理员登录。\n\n**关联字典**：\n- menu_type（菜单类型）：返回字段menuType（DIRECTORY=目录, MENU=菜单, BUTTON=按钮）\n- common_status（通用状态）：返回字段status",
+        "description": "获取指定菜单的详细信息，包括名称、路径、组件、图标、排序、权限标识等。\n\n**权限**：需要管理员登录。\n\n**关联字典**：\n- menu_type（菜单类型）：返回字段menuType（D=目录, M=菜单, B=按钮）\n- common_status（通用状态）：返回字段status",
         "operationId": "getMenuUsingGET",
         "produces": [
           "*/*"
@@ -6820,7 +6878,7 @@
           "菜单管理接口"
         ],
         "summary": "更新菜单",
-        "description": "更新指定菜单的名称、路径、组件、图标、排序、状态等信息。\n\n**权限**：需要SUPER_ADMIN角色。\n**注意**：修改后需清除 Redis 菜单缓存才能生效。\n\n**关联字典**：\n- menu_type（菜单类型）：请求字段menuType（DIRECTORY=目录, MENU=菜单, BUTTON=按钮）\n- common_status（通用状态）：请求字段status",
+        "description": "更新指定菜单的名称、路径、组件、图标、排序、状态等信息。\n\n**权限**：需要SUPER_ADMIN角色。\n**注意**：修改后需清除 Redis 菜单缓存才能生效。\n\n**关联字典**：\n- menu_type（菜单类型）：请求字段menuType（D=目录, M=菜单, B=按钮）\n- common_status（通用状态）：请求字段status",
         "operationId": "updateMenuUsingPUT",
         "consumes": [
           "application/json"
@@ -7466,7 +7524,7 @@
           "字典管理接口"
         ],
         "summary": "分页查询字典类型",
-        "description": "分页查询字典类型列表，支持按分类（category）筛选。字典类型是字典数据的上级分组，管理字典类型即管理有哪些可供前端使用的下拉选项组。",
+        "description": "分页查询字典类型列表，支持按分类（category）筛选、关键词（keyword）搜索。keyword 同时匹配字典类型编码（dict_type）和字典名称（dict_name），模糊搜索。字典类型是字典数据的上级分组，管理字典类型即管理有哪些可供前端使用的下拉选项组。",
         "operationId": "listDictTypesUsingGET",
         "produces": [
           "*/*"
@@ -7480,6 +7538,14 @@
             "type": "string",
             "allowEmptyValue": false
           },
+          {
+            "name": "keyword",
+            "in": "query",
+            "description": "搜索关键词（匹配字典编码或名称）",
+            "required": false,
+            "type": "string",
+            "allowEmptyValue": false
+          },
           {
             "name": "page",
             "in": "query",
@@ -10304,7 +10370,7 @@
           "type": "integer",
           "format": "int32",
           "example": 1,
-          "description": "性别，关联字典gender：0=女, 1=男"
+          "description": "性别，关联字典gender：1=男, 2=女"
         },
         "idCardNo": {
           "type": "string",
@@ -10591,7 +10657,7 @@
         "gender": {
           "type": "integer",
           "format": "int32",
-          "description": "性别，关联字典gender：0=女, 1=男"
+          "description": "性别，关联字典gender：1=男, 2=女"
         },
         "idCardNo": {
           "type": "string",
@@ -11141,6 +11207,76 @@
       "title": "创建管理员请求",
       "description": "创建后台管理员账号，默认密码Admin@123456"
     },
+    "旅行设计师VO": {
+      "type": "object",
+      "properties": {
+        "avatar": {
+          "type": "string",
+          "description": "头像URL"
+        },
+        "certLevel": {
+          "type": "string",
+          "description": "认证等级：none/bronze/silver/gold/diamond"
+        },
+        "certLevelLabel": {
+          "type": "string",
+          "description": "认证等级中文标签"
+        },
+        "certified": {
+          "type": "boolean",
+          "description": "是否已认证"
+        },
+        "description": {
+          "type": "string",
+          "description": "个人简介"
+        },
+        "experience": {
+          "type": "integer",
+          "format": "int32",
+          "description": "从业年限"
+        },
+        "id": {
+          "type": "string",
+          "description": "设计师ID"
+        },
+        "motto": {
+          "type": "string",
+          "description": "座右铭"
+        },
+        "name": {
+          "type": "string",
+          "description": "设计师姓名"
+        },
+        "phone": {
+          "type": "string",
+          "description": "联系电话"
+        },
+        "rating": {
+          "type": "string",
+          "description": "评分"
+        },
+        "routeCount": {
+          "type": "integer",
+          "format": "int32",
+          "description": "设计路线数量"
+        },
+        "serviceAreas": {
+          "type": "array",
+          "description": "服务区域",
+          "items": {
+            "type": "string"
+          }
+        },
+        "specialties": {
+          "type": "array",
+          "description": "擅长领域",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "title": "旅行设计师VO"
+    },
     "更新管理员请求": {
       "type": "object",
       "properties": {
@@ -11192,6 +11328,31 @@
       },
       "title": "统一响应结果«AdminUser»"
     },
+    "统一响应结果«List«旅行设计师VO»»": {
+      "type": "object",
+      "properties": {
+        "code": {
+          "type": "integer",
+          "format": "int32",
+          "example": 200,
+          "description": "状态码"
+        },
+        "data": {
+          "type": "array",
+          "description": "响应数据",
+          "items": {
+            "originalRef": "旅行设计师VO",
+            "$ref": "#/definitions/旅行设计师VO"
+          }
+        },
+        "message": {
+          "type": "string",
+          "example": "成功",
+          "description": "响应消息"
+        }
+      },
+      "title": "统一响应结果«List«旅行设计师VO»»"
+    },
     "统一响应结果«Map«string,object»»": {
       "type": "object",
       "properties": {
@@ -11591,7 +11752,7 @@
         "status": {
           "type": "integer",
           "format": "int32",
-          "description": "状态，关联字典common_status：0=下线, 1=上线"
+          "description": "状态，关联字典common_status：ACTIVE=启用, INACTIVE=停用"
         },
         "subtitle": {
           "type": "string",
@@ -11638,8 +11799,8 @@
         "status": {
           "type": "integer",
           "format": "int32",
-          "example": 1,
-          "description": "状态，关联字典common_status：0=下线, 1=上线"
+          "example": "ACTIVE",
+          "description": "状态，关联字典common_status：ACTIVE=启用, INACTIVE=停用"
         },
         "subtitle": {
           "type": "string",
@@ -13067,8 +13228,8 @@
         },
         "menuType": {
           "type": "string",
-          "example": "MENU",
-          "description": "菜单类型：DIRECTORY=目录 MENU=菜单 BUTTON=按钮"
+          "example": "M",
+          "description": "菜单类型：D=目录 M=菜单 B=按钮（关联字典menu_type）"
         },
         "parentId": {
           "type": "integer",
@@ -13125,8 +13286,8 @@
         },
         "menuType": {
           "type": "string",
-          "example": "MENU",
-          "description": "菜单类型：DIRECTORY=目录 MENU=菜单 BUTTON=按钮"
+          "example": "M",
+          "description": "菜单类型：D=目录 M=菜单 B=按钮（关联字典menu_type）"
         },
         "parentId": {
           "type": "integer",