feat: Dataset pagination; camelCase support in schemas (#22)

implement pagination for dataset mappings.
update response models to support camelCase parameters.

runtime/label-studio-adapter/app/schemas/common.py

@@ -1,13 +1,27 @@
 """
 通用响应模型
 """
-from typing import Generic, TypeVar, Optional
+from typing import Generic, TypeVar, Optional, List
 from pydantic import BaseModel, Field
 
 # 定义泛型类型变量
 T = TypeVar('T')
 
-class StandardResponse(BaseModel, Generic[T]):
+# 定义一个将 snake_case 转换为 camelCase 的函数
+def to_camel(string: str) -> str:
+    """将 snake_case 字符串转换为 camelCase"""
+    components = string.split('_')
+    # 首字母小写，其余单词首字母大写
+    return components[0] + ''.join(x.title() for x in components[1:])
+
+class BaseResponseModel(BaseModel):
+    """基础响应模型，启用别名生成器"""
+    
+    class Config:
+        populate_by_name = True
+        alias_generator = to_camel
+
+class StandardResponse(BaseResponseModel, Generic[T]):
     """
     标准API响应格式
     
@@ -18,6 +32,8 @@ class StandardResponse(BaseModel, Generic[T]):
     data: Optional[T] = Field(None, description="响应数据")
     
     class Config:
+        populate_by_name = True
+        alias_generator = to_camel
         json_schema_extra = {
             "example": {
                 "code": 200,
@@ -25,3 +41,23 @@ class StandardResponse(BaseModel, Generic[T]):
                 "data": {}
             }
         }
+
+
+class PaginatedData(BaseResponseModel, Generic[T]):
+    """分页数据容器"""
+    page: int = Field(..., description="当前页码（从1开始）")
+    size: int = Field(..., description="页大小")
+    total_elements: int = Field(..., description="总条数")
+    total_pages: int = Field(..., description="总页数")
+    content: List[T] = Field(..., description="当前页数据")
+    
+    class Config:
+        json_schema_extra = {
+            "example": {
+                "page": 1,
+                "size": 20,
+                "totalElements": 100,
+                "totalPages": 5,
+                "content": []
+            }
+        }

runtime/label-studio-adapter/app/schemas/dataset_mapping.py

@@ -1,8 +1,10 @@
-from pydantic import BaseModel, Field
+from pydantic import Field
 from typing import Optional
 from datetime import datetime
 
-class DatasetMappingBase(BaseModel):
+from .common import BaseResponseModel
+
+class DatasetMappingBase(BaseResponseModel):
     """数据集映射 基础模型"""
     source_dataset_id: str = Field(..., description="源数据集ID")
 
@@ -10,14 +12,14 @@ class DatasetMappingCreateRequest(DatasetMappingBase):
     """数据集映射 创建 请求模型"""
     pass
 
-class DatasetMappingCreateResponse(BaseModel):
+class DatasetMappingCreateResponse(BaseResponseModel):
     """数据集映射 创建 响应模型"""
     mapping_id: str = Field(..., description="映射UUID")
     labelling_project_id: str = Field(..., description="Label Studio项目ID")
     labelling_project_name: str = Field(..., description="Label Studio项目名称")
     message: str = Field(..., description="响应消息")
 
-class DatasetMappingUpdateRequest(BaseModel):
+class DatasetMappingUpdateRequest(BaseResponseModel):
     """数据集映射 更新 请求模型"""
     source_dataset_id: Optional[str] = Field(None, description="源数据集ID")
 
@@ -32,13 +34,14 @@ class DatasetMappingResponse(DatasetMappingBase):
     
     class Config:
         from_attributes = True
+        populate_by_name = True
 
-class SyncDatasetRequest(BaseModel):
+class SyncDatasetRequest(BaseResponseModel):
     """同步数据集请求模型"""
     mapping_id: str = Field(..., description="映射ID（mapping UUID）")
     batch_size: int = Field(50, ge=1, le=100, description="批处理大小")
 
-class SyncDatasetResponse(BaseModel):
+class SyncDatasetResponse(BaseResponseModel):
     """同步数据集响应模型"""
     mapping_id: str = Field(..., description="映射UUID")
     status: str = Field(..., description="同步状态")
@@ -46,7 +49,7 @@ class SyncDatasetResponse(BaseModel):
     total_files: int = Field(0, description="总文件数量")
     message: str = Field(..., description="响应消息")
 
-class DeleteDatasetResponse(BaseModel):
+class DeleteDatasetResponse(BaseResponseModel):
     """删除数据集响应模型"""
     mapping_id: str = Field(..., description="映射UUID")
     status: str = Field(..., description="删除状态")

runtime/label-studio-adapter/app/schemas/label_studio.py

@@ -1,8 +1,9 @@
-from pydantic import BaseModel, Field
+from pydantic import Field
 from typing import Dict, Any, Optional, List
 from datetime import datetime
+from .common import BaseResponseModel
 
-class LabelStudioProject(BaseModel):
+class LabelStudioProject(BaseResponseModel):
     """Label Studio项目模型"""
     id: int = Field(..., description="项目ID")
     title: str = Field(..., description="项目标题")
@@ -11,7 +12,7 @@ class LabelStudioProject(BaseModel):
     created_at: Optional[datetime] = Field(None, description="创建时间")
     updated_at: Optional[datetime] = Field(None, description="更新时间")
 
-class LabelStudioTaskData(BaseModel):
+class LabelStudioTaskData(BaseResponseModel):
     """Label Studio任务数据模型"""
     image: Optional[str] = Field(None, description="图像URL")
     text: Optional[str] = Field(None, description="文本内容")
@@ -19,19 +20,19 @@ class LabelStudioTaskData(BaseModel):
     video: Optional[str] = Field(None, description="视频URL")
     filename: Optional[str] = Field(None, description="文件名")
 
-class LabelStudioTask(BaseModel):
+class LabelStudioTask(BaseResponseModel):
     """Label Studio任务模型"""
     data: LabelStudioTaskData = Field(..., description="任务数据")
     project: Optional[int] = Field(None, description="项目ID")
     meta: Optional[Dict[str, Any]] = Field(None, description="元数据")
 
-class LabelStudioCreateProjectRequest(BaseModel):
+class LabelStudioCreateProjectRequest(BaseResponseModel):
     """创建Label Studio项目请求模型"""
     title: str = Field(..., description="项目标题")
     description: str = Field("", description="项目描述")
     label_config: str = Field(..., description="标注配置")
     
-class LabelStudioCreateTaskRequest(BaseModel):
+class LabelStudioCreateTaskRequest(BaseResponseModel):
     """创建Label Studio任务请求模型"""
     data: Dict[str, Any] = Field(..., description="任务数据")
     project: Optional[int] = Field(None, description="项目ID")