chore: enhance serializers and add new parameters for chat and resource mapping APIs

apps/chat/views/v2/chat.py

@@ -303,6 +303,14 @@ class CaptchaView(APIView):
         description=_("Get Chat captcha"),
         operation_id=_("Get Chat captcha"),  # type: ignore
         tags=[_("Chat")],  # type: ignore
+        parameters=[
+            OpenApiParameter(
+                name="accessToken",
+                type=OpenApiTypes.STR,
+                location=OpenApiParameter.QUERY,
+                required=False,
+            )
+        ],
         responses=CaptchaAPI.get_response(),
     )
     def get(self, request: Request):

apps/system_manage/api/chat_user.py

@@ -104,12 +104,6 @@ class ChatUserListResponse(serializers.Serializer):
     email = serializers.EmailField(required=False, allow_blank=True, label=_("Email"))
     phone = serializers.CharField(required=False, allow_blank=True, label=_("Phone"))
     is_active = serializers.BooleanField(required=False, default=True, label=_("Is Active"))
-    user_group_ids = serializers.ListField(
-        child=serializers.CharField(required=True), required=True, label=_("User Group IDs")
-    )
-    user_group_names = serializers.ListField(
-        child=serializers.CharField(required=True), required=True, label=_("User Group Names")
-    )
 
 
 class ChatUsersListResponse(ResultSerializer):

apps/system_manage/api/resource_mapping.py

@@ -1,80 +1,104 @@
 # coding=utf-8
 """
-    @project: MaxKB
-    @Author：虎虎
-    @file： resource_mapping.py
-    @date：2025/12/26 14:07
-    @desc:
+@project: MaxKB
+@Author：虎虎
+@file： resource_mapping.py
+@date：2025/12/26 14:07
+@desc:
 """
+
 from django.utils.translation import gettext_lazy as _
 from drf_spectacular.types import OpenApiTypes
 from drf_spectacular.utils import OpenApiParameter
 from rest_framework import serializers
 
 from common.mixins.api_mixin import APIMixin
+from common.result import ResultPageSerializer
 
 
-class ResourceMappingResponse(serializers.Serializer):
+class ResourceMappingItemResponse(serializers.Serializer):
     id = serializers.UUIDField(required=True, label="主键id")
-    target_id = serializers.CharField(required=True, label="被关联资源名称")
+    target_id = serializers.CharField(required=True, label="被关联资源Id")
     target_type = serializers.CharField(required=True, label="被关联资源类型")
     source_id = serializers.CharField(required=True, label="关联资源Id")
     source_type = serializers.CharField(required=True, label="关联资源类型")
     name = serializers.CharField(required=True, label="名称")
-    desc = serializers.CharField(required=False, label="描述")
+    desc = serializers.CharField(required=False, allow_blank=True, allow_null=True, label="描述")
     user_id = serializers.UUIDField(required=True, label="主键id")
+    workspace_id = serializers.CharField(required=True, label="工作空间id")
+    icon = serializers.CharField(required=False, allow_blank=True, allow_null=True, label="资源图标")
+    type = serializers.CharField(required=False, allow_blank=True, allow_null=True, label="资源类型")
+    folder_id = serializers.CharField(required=False, allow_blank=True, allow_null=True, label="文件夹id")
+    username = serializers.CharField(required=False, allow_blank=True, allow_null=True, label="创建人")
+    workspace_name = serializers.CharField(required=False, allow_blank=True, allow_null=True, label="工作空间名称")
+    create_time = serializers.DateTimeField(required=True, label="创建时间")
+    update_time = serializers.DateTimeField(required=True, label="更新时间")
 
 
-class ResourceMappingAPI(APIMixin):
+class ResourceMappingResponse(ResultPageSerializer):
+    def get_data(self):
+        return ResourceMappingItemResponse(many=True)
+
 
+class ResourceMappingAPI(APIMixin):
     @staticmethod
     def get_parameters():
         return [
             OpenApiParameter(
                 name="workspace_id",
                 description="工作空间id",
                 type=OpenApiTypes.STR,
-                location='path',
+                location="path",
                 required=True,
             ),
             OpenApiParameter(
-                name="source",
+                name="resource",
                 description="资源类型",
                 type=OpenApiTypes.STR,
-                location='path',
+                location="path",
                 required=True,
             ),
             OpenApiParameter(
-                name="source_id",
+                name="resource_id",
                 description="资源id",
                 type=OpenApiTypes.STR,
-                location='path',
+                location="path",
                 required=True,
             ),
             OpenApiParameter(
                 name="current_page",
                 description=_("Current page"),
                 type=OpenApiTypes.INT,
-                location='path',
+                location="path",
                 required=True,
             ),
             OpenApiParameter(
                 name="page_size",
                 description=_("Page size"),
                 type=OpenApiTypes.INT,
-                location='path',
+                location="path",
                 required=True,
             ),
             OpenApiParameter(
-                name="resource_name",
-                description="名称",
+                name="resource_name", description="名称", type=OpenApiTypes.STR, location="query", required=False
+            ),
+            OpenApiParameter(
+                name="user_name",
+                description="创建人",
                 type=OpenApiTypes.STR,
-                location='query',
-                required=False
+                location="query",
+                required=False,
+            ),
+            OpenApiParameter(
+                name="source_type[]",
+                description="关联资源类型",
+                type=OpenApiTypes.STR,
+                location="query",
+                many=True,
+                required=False,
             ),
-
         ]
 
     @staticmethod
     def get_response():
-        return ResourceMappingResponse(many=True)
+        return ResourceMappingResponse