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": []
+            }
+        }