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

.swagger/dict_data.json

@@ -4123,14 +4123,14 @@
         "status": "ACTIVE"
       },
       {
-        "value": "KING",
-        "label": "\u8c6a\u534e\u5927\u5e8a",
+        "value": "DELUXE",
+        "label": "\u8c6a\u534e\u623f",
         "sort": 5,
         "status": "ACTIVE"
       },
       {
-        "value": "DELUXE",
-        "label": "\u8c6a\u534e\u623f",
+        "value": "KING",
+        "label": "\u8c6a\u534e\u5927\u5e8a",
         "sort": 5,
         "status": "ACTIVE"
       },
@@ -4171,6 +4171,12 @@
     "category": "BUSINESS",
     "remark": "Room-level facilities",
     "items": [
+      {
+        "value": "kettle",
+        "label": "\u70ed\u6c34\u58f6",
+        "sort": 1,
+        "status": "ACTIVE"
+      },
       {
         "value": "slippers",
         "label": "\u62d6\u978b",
@@ -4202,9 +4208,15 @@
         "status": "ACTIVE"
       },
       {
-        "value": "kettle",
-        "label": "\u70ed\u6c34\u58f6",
-        "sort": 1,
+        "value": "safe",
+        "label": "\u4fdd\u9669\u7bb1",
+        "sort": 2,
+        "status": "ACTIVE"
+      },
+      {
+        "value": "mini_fridge",
+        "label": "\u5c0f\u51b0\u7bb1",
+        "sort": 2,
         "status": "ACTIVE"
       },
       {
@@ -4232,15 +4244,21 @@
         "status": "ACTIVE"
       },
       {
-        "value": "safe",
-        "label": "\u4fdd\u9669\u7bb1",
-        "sort": 2,
+        "value": "desk",
+        "label": "\u4e66\u684c",
+        "sort": 3,
         "status": "ACTIVE"
       },
       {
-        "value": "mini_fridge",
-        "label": "\u5c0f\u51b0\u7bb1",
-        "sort": 2,
+        "value": "kids_toiletry",
+        "label": "\u513f\u7ae5\u6d17\u6f31\u7528\u54c1",
+        "sort": 3,
+        "status": "ACTIVE"
+      },
+      {
+        "value": "toiletries",
+        "label": "\u514d\u8d39\u6d17\u6f31\u7528\u54c1",
+        "sort": 3,
         "status": "ACTIVE"
       },
       {
@@ -4262,21 +4280,21 @@
         "status": "ACTIVE"
       },
       {
-        "value": "desk",
-        "label": "\u4e66\u684c",
-        "sort": 3,
+        "value": "corner_guard",
+        "label": "\u9632\u649e\u89d2",
+        "sort": 4,
         "status": "ACTIVE"
       },
       {
-        "value": "kids_toiletry",
-        "label": "\u513f\u7ae5\u6d17\u6f31\u7528\u54c1",
-        "sort": 3,
+        "value": "sofa",
+        "label": "\u6c99\u53d1",
+        "sort": 4,
         "status": "ACTIVE"
       },
       {
-        "value": "toiletries",
-        "label": "\u514d\u8d39\u6d17\u6f31\u7528\u54c1",
-        "sort": 3,
+        "value": "floor_heat",
+        "label": "\u5730\u6696",
+        "sort": 4,
         "status": "ACTIVE"
       },
       {
@@ -4297,36 +4315,6 @@
         "sort": 4,
         "status": "ACTIVE"
       },
-      {
-        "value": "corner_guard",
-        "label": "\u9632\u649e\u89d2",
-        "sort": 4,
-        "status": "ACTIVE"
-      },
-      {
-        "value": "sofa",
-        "label": "\u6c99\u53d1",
-        "sort": 4,
-        "status": "ACTIVE"
-      },
-      {
-        "value": "floor_heat",
-        "label": "\u5730\u6696",
-        "sort": 4,
-        "status": "ACTIVE"
-      },
-      {
-        "value": "usb_port",
-        "label": "USB\u5145\u7535\u53e3",
-        "sort": 5,
-        "status": "ACTIVE"
-      },
-      {
-        "value": "coffee",
-        "label": "\u5496\u5561\u673a",
-        "sort": 5,
-        "status": "ACTIVE"
-      },
       {
         "value": "bath_towel",
         "label": "\u6d74\u5dfe",
@@ -4346,15 +4334,15 @@
         "status": "ACTIVE"
       },
       {
-        "value": "bt_speaker",
-        "label": "\u84dd\u7259\u97f3\u7bb1",
-        "sort": 6,
+        "value": "usb_port",
+        "label": "USB\u5145\u7535\u53e3",
+        "sort": 5,
         "status": "ACTIVE"
       },
       {
-        "value": "smart_toilet",
-        "label": "\u667a\u80fd\u9a6c\u6876",
-        "sort": 6,
+        "value": "coffee",
+        "label": "\u5496\u5561\u673a",
+        "sort": 5,
         "status": "ACTIVE"
       },
       {
@@ -4375,6 +4363,24 @@
         "sort": 6,
         "status": "ACTIVE"
       },
+      {
+        "value": "bt_speaker",
+        "label": "\u84dd\u7259\u97f3\u7bb1",
+        "sort": 6,
+        "status": "ACTIVE"
+      },
+      {
+        "value": "smart_toilet",
+        "label": "\u667a\u80fd\u9a6c\u6876",
+        "sort": 6,
+        "status": "ACTIVE"
+      },
+      {
+        "value": "bathrobe",
+        "label": "\u6d74\u888d",
+        "sort": 7,
+        "status": "ACTIVE"
+      },
       {
         "value": "mirror",
         "label": "\u5168\u8eab\u955c",
@@ -4393,18 +4399,6 @@
         "sort": 7,
         "status": "ACTIVE"
       },
-      {
-        "value": "bathrobe",
-        "label": "\u6d74\u888d",
-        "sort": 7,
-        "status": "ACTIVE"
-      },
-      {
-        "value": "air_purifier",
-        "label": "\u7a7a\u6c14\u51c0\u5316\u5668",
-        "sort": 8,
-        "status": "ACTIVE"
-      },
       {
         "value": "power_220v",
         "label": "220V\u7535\u6e90\u63d2\u5ea7",
@@ -4424,9 +4418,9 @@
         "status": "ACTIVE"
       },
       {
-        "value": "body_wash",
-        "label": "\u6c90\u6d74\u9732",
-        "sort": 9,
+        "value": "air_purifier",
+        "label": "\u7a7a\u6c14\u51c0\u5316\u5668",
+        "sort": 8,
         "status": "ACTIVE"
       },
       {
@@ -4434,6 +4428,12 @@
         "label": "\u624b\u673a\u6295\u5c4f",
         "sort": 9,
         "status": "ACTIVE"
+      },
+      {
+        "value": "body_wash",
+        "label": "\u6c90\u6d74\u9732",
+        "sort": 9,
+        "status": "ACTIVE"
       }
     ]
   },
@@ -4959,6 +4959,30 @@
       }
     ]
   },
+  "test_e2e_chinese_cat": {
+    "name": "\u4e2d\u6587\u5206\u7c7b\u6d4b\u8bd5",
+    "category": "E2E\u6d4b\u8bd5",
+    "remark": "",
+    "items": []
+  },
+  "test_e2e_custom_cat": {
+    "name": "custom cat test",
+    "category": "CUSTOM",
+    "remark": "",
+    "items": []
+  },
+  "test_e2e_debug_0318": {
+    "name": "debug dict",
+    "category": "BASE",
+    "remark": "",
+    "items": []
+  },
+  "test_e2e_debug_0318b": {
+    "name": "debug dict 2",
+    "category": "BASE",
+    "remark": "",
+    "items": []
+  },
   "transmission": {
     "name": "\u53d8\u901f\u7bb1",
     "category": "BUSINESS",

.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",

changelogs/2026-03/18_1130_sync.md

@@ -0,0 +1,24 @@
+# API 变更通知
+
+**更新时间**: 2026-03-18 11:31
+
+## ℹ️ 新增 (6)
+
+### 用户服务
+
+**新增接口**
+
+- 🆕 `GET /admin/user/designers`
+
+**新增参数**
+
+- `GET /admin/dict/type` 新增参数 `keyword`
+
+### 字典变更
+
+**新增字典类型**
+
+- 🆕 `test_e2e_chinese_cat`（中文分类测试）
+- 🆕 `test_e2e_custom_cat`（custom cat test）
+- 🆕 `test_e2e_debug_0318`（debug dict）
+- 🆕 `test_e2e_debug_0318b`（debug dict 2）