Develop py update schema (#37)

* feature: implement endpoints with multi-level response models
* refactor: move `/health` and `/config` endpoints to system module, remove example from base schemas
* refactor: remove unused get_standard_response_model()

Author: JasonW404

runtime/datamate-python/app/module/__init__.py

@@ -1,11 +1,13 @@
 from fastapi import APIRouter
 
+from .system.interface import router as system_router
 from .annotation.interface import router as annotation_router
 
 router = APIRouter(
     prefix="/api"
 )
 
+router.include_router(system_router)
 router.include_router(annotation_router)
 
 __all__ = ["router"]

runtime/datamate-python/app/module/annotation/interface/project.py

@@ -108,8 +108,7 @@ async def create_mapping(
         response_data = DatasetMappingCreateResponse(
             id=mapping.id,
             labeling_project_id=str(mapping.labeling_project_id),
-            labeling_project_name=mapping.name or project_name,
-            message="Dataset mapping created successfully"
+            labeling_project_name=mapping.name or project_name
         )
 
         return StandardResponse(
@@ -341,8 +340,7 @@ async def delete_mapping(
             message="success",
             data=DeleteDatasetResponse(
                 id=id,
-                status="success",
-                message=f"Successfully deleted mapping and Label Studio project '{labeling_project_name}'"
+                status="success"
             )
         )
 

runtime/datamate-python/app/module/annotation/schema/__init__.py

@@ -1,24 +1,24 @@
 from .mapping import (
-    DatasetMappingBase,
+    _DatasetMappingBase,
     DatasetMappingCreateRequest,
     DatasetMappingCreateResponse,
     DatasetMappingUpdateRequest,
     DatasetMappingResponse,
-    DeleteDatasetResponse
+    DeleteDatasetResponse,
 )
 
 from .sync import (
     SyncDatasetRequest,
-    SyncDatasetResponse
+    SyncDatasetResponse,
 )
 
 __all__ = [
-    "DatasetMappingBase",
+    "_DatasetMappingBase",
     "DatasetMappingCreateRequest",
     "DatasetMappingCreateResponse",
     "DatasetMappingUpdateRequest",
     "DatasetMappingResponse",
     "SyncDatasetRequest",
     "SyncDatasetResponse",
-    "DeleteDatasetResponse"
+    "DeleteDatasetResponse",
 ]

runtime/datamate-python/app/module/annotation/schema/mapping.py

@@ -3,12 +3,13 @@
 from datetime import datetime
 
 from app.module.shared.schema import BaseResponseModel
+from app.module.shared.schema import StandardResponse
 
-class DatasetMappingBase(BaseResponseModel):
+class _DatasetMappingBase(BaseResponseModel):
     """数据集映射 基础模型"""
     dataset_id: str = Field(..., description="源数据集ID")
 
-class DatasetMappingCreateRequest(DatasetMappingBase):
+class DatasetMappingCreateRequest(_DatasetMappingBase):
     """数据集映射 创建 请求模型"""
     pass
 
@@ -17,13 +18,12 @@ class DatasetMappingCreateResponse(BaseResponseModel):
     id: str = Field(..., description="映射UUID")
     labeling_project_id: str = Field(..., description="Label Studio项目ID")
     labeling_project_name: str = Field(..., description="Label Studio项目名称")
-    message: str = Field(..., description="响应消息")
 
 class DatasetMappingUpdateRequest(BaseResponseModel):
     """数据集映射 更新 请求模型"""
     dataset_id: Optional[str] = Field(None, description="源数据集ID")
 
-class DatasetMappingResponse(DatasetMappingBase):
+class DatasetMappingResponse(_DatasetMappingBase):
     """数据集映射 查询 响应模型"""
     id: str = Field(..., description="映射UUID")
     labeling_project_id: str = Field(..., description="标注项目ID")
@@ -38,5 +38,4 @@ class Config:
 class DeleteDatasetResponse(BaseResponseModel):
     """删除数据集响应模型"""
     id: str = Field(..., description="映射UUID")
-    status: str = Field(..., description="删除状态")
-    message: str = Field(..., description="响应消息")
+    status: str = Field(..., description="删除状态")

runtime/datamate-python/app/module/annotation/schema/sync.py

@@ -1,8 +1,7 @@
 from pydantic import Field
-from typing import Optional
-from datetime import datetime
 
 from app.module.shared.schema import BaseResponseModel
+from app.module.shared.schema import StandardResponse
 
 
 class SyncDatasetRequest(BaseResponseModel):
@@ -17,3 +16,6 @@ class SyncDatasetResponse(BaseResponseModel):
     synced_files: int = Field(..., description="已同步文件数量")
     total_files: int = Field(0, description="总文件数量")
     message: str = Field(..., description="响应消息")
+
+class SyncDatasetResponseStd(StandardResponse[SyncDatasetResponse]):
+    pass

runtime/datamate-python/app/module/management/api/__init__.py

@@ -1,7 +1,7 @@
 """
 通用响应模型
 """
-from typing import Generic, TypeVar, Optional, List
+from typing import Generic, TypeVar, Optional, List, Type
 from pydantic import BaseModel, Field
 
 # 定义泛型类型变量
@@ -29,18 +29,11 @@ class StandardResponse(BaseResponseModel, Generic[T]):
     """
     code: int = Field(..., description="HTTP状态码")
     message: str = Field(..., description="响应消息")
-    data: Optional[T] = Field(None, description="响应数据")
-    
+    data: T = Field(..., description="响应数据")
+
     class Config:
         populate_by_name = True
         alias_generator = to_camel
-        json_schema_extra = {
-            "example": {
-                "code": 200,
-                "message": "success",
-                "data": {}
-            }
-        }
 
 class PaginatedData(BaseResponseModel, Generic[T]):
     """分页数据容器"""
@@ -49,14 +42,3 @@ class PaginatedData(BaseResponseModel, Generic[T]):
     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": []
-            }
-        }