feat: Enhance file tag update functionality with automatic format conversion (#84)

- Updated `update_file_tags` to support both simplified and full tag formats.
- Introduced `TagFormatConverter` to handle conversion from simplified external tags to internal storage format.
- Added logic to fetch and utilize the appropriate annotation template for conversion.
- Improved error handling for missing templates and unknown controls during tag updates.
- Created example script demonstrating the usage of the new tag format conversion feature.
- Added unit tests for `TagFormatConverter` to ensure correct functionality and edge case handling.

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

@@ -3,14 +3,6 @@ from .config import (
     TagConfigResponse
 )
 
-from .mapping import (
-    DatasetMappingCreateRequest,
-    DatasetMappingCreateResponse,
-    DatasetMappingUpdateRequest,
-    DatasetMappingResponse,
-    DeleteDatasetResponse,
-)
-
 from .sync import (
     SyncDatasetRequest,
     SyncDatasetResponse,
@@ -30,6 +22,17 @@ from .template import (
     AnnotationTemplateListResponse
 )
 
+from .mapping import (
+    DatasetMappingCreateRequest,
+    DatasetMappingCreateResponse,
+    DatasetMappingUpdateRequest,
+    DatasetMappingResponse,
+    DeleteDatasetResponse,
+)
+
+# Rebuild model to resolve forward references
+DatasetMappingResponse.model_rebuild()
+
 __all__ = [
     "ConfigResponse",
     "TagConfigResponse",

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

@@ -1,10 +1,13 @@
 from pydantic import Field, BaseModel
-from typing import Optional
+from typing import Optional, TYPE_CHECKING
 from datetime import datetime
 
 from app.module.shared.schema import BaseResponseModel
 from app.module.shared.schema import StandardResponse
 
+if TYPE_CHECKING:
+    from .template import AnnotationTemplateResponse
+
 
 class DatasetMappingCreateRequest(BaseModel):
     """数据集映射 创建 请求模型
@@ -42,6 +45,8 @@ class DatasetMappingResponse(BaseModel):
     labeling_project_id: str = Field(..., alias="labelingProjectId", description="标注项目ID")
     name: Optional[str] = Field(None, description="标注项目名称")
     description: Optional[str] = Field(None, description="标注项目描述")
+    template_id: Optional[str] = Field(None, alias="templateId", description="关联的模板ID")
+    template: Optional['AnnotationTemplateResponse'] = Field(None, description="关联的标注模板详情")
     created_at: datetime = Field(..., alias="createdAt", description="创建时间")
     updated_at: Optional[datetime] = Field(None, alias="updatedAt", description="更新时间")
     deleted_at: Optional[datetime] = Field(None, alias="deletedAt", description="删除时间")