feat: Add labeling template (#72)

* feat: Enhance annotation module with template management and validation

- Added DatasetMappingCreateRequest and DatasetMappingUpdateRequest schemas to handle dataset mapping requests with camelCase and snake_case support.
- Introduced Annotation Template schemas including CreateAnnotationTemplateRequest, UpdateAnnotationTemplateRequest, and AnnotationTemplateResponse for managing annotation templates.
- Implemented AnnotationTemplateService for creating, updating, retrieving, and deleting annotation templates, including validation of configurations and XML generation.
- Added utility class LabelStudioConfigValidator for validating Label Studio configurations and XML formats.
- Updated database schema for annotation templates and labeling projects to include new fields and constraints.
- Seeded initial annotation templates for various use cases including image classification, object detection, and text classification.

* feat: Enhance TemplateForm with improved validation and dynamic field rendering; update LabelStudio config validation for camelCase support

* feat: Update docker-compose.yml to mark datamate dataset volume and network as external

runtime/datamate-python/app/module/annotation/utils/config_validator.py

@@ -0,0 +1,263 @@
+"""
+Label Studio Configuration Validation Utilities
+"""
+from typing import Dict, List, Tuple, Optional
+import xml.etree.ElementTree as ET
+
+
+class LabelStudioConfigValidator:
+    """验证Label Studio配置的工具类"""
+    
+    # 支持的控件类型
+    CONTROL_TYPES = {
+        'Choices', 'RectangleLabels', 'PolygonLabels', 'Labels', 
+        'TextArea', 'Rating', 'KeyPointLabels', 'BrushLabels',
+        'EllipseLabels', 'VideoRectangle', 'AudioPlus'
+    }
+    
+    # 支持的对象类型
+    OBJECT_TYPES = {
+        'Image', 'Text', 'Audio', 'Video', 'HyperText', 
+        'AudioPlus', 'Paragraphs', 'Table'
+    }
+    
+    # 需要子标签的控件类型
+    LABEL_BASED_CONTROLS = {
+        'Choices', 'RectangleLabels', 'PolygonLabels', 'Labels',
+        'KeyPointLabels', 'BrushLabels', 'EllipseLabels'
+    }
+    
+    @staticmethod
+    def validate_xml(xml_string: str) -> Tuple[bool, Optional[str]]:
+        """
+        验证XML格式是否正确
+        
+        Args:
+            xml_string: Label Studio XML配置字符串
+            
+        Returns:
+            (是否有效, 错误信息)
+        """
+        try:
+            root = ET.fromstring(xml_string)
+            
+            # 检查根元素
+            if root.tag != 'View':
+                return False, "Root element must be <View>"
+            
+            # 检查是否有对象定义
+            objects = [child for child in root if child.tag in LabelStudioConfigValidator.OBJECT_TYPES]
+            if not objects:
+                return False, "No data objects (Image, Text, etc.) found"
+            
+            # 检查是否有控件定义
+            controls = [child for child in root if child.tag in LabelStudioConfigValidator.CONTROL_TYPES]
+            if not controls:
+                return False, "No annotation controls found"
+            
+            # 验证每个控件
+            for control in controls:
+                valid, error = LabelStudioConfigValidator._validate_control(control)
+                if not valid:
+                    return False, f"Control {control.tag}: {error}"
+            
+            return True, None
+            
+        except ET.ParseError as e:
+            return False, f"XML parse error: {str(e)}"
+        except Exception as e:
+            return False, f"Validation error: {str(e)}"
+    
+    @staticmethod
+    def _validate_control(control: ET.Element) -> Tuple[bool, Optional[str]]:
+        """
+        验证单个控件元素
+        
+        Args:
+            control: 控件XML元素
+            
+        Returns:
+            (是否有效, 错误信息)
+        """
+        # 检查必需属性
+        if 'name' not in control.attrib:
+            return False, "Missing 'name' attribute"
+        
+        if 'toName' not in control.attrib:
+            return False, "Missing 'toName' attribute"
+        
+        # 检查标签型控件是否有子标签
+        if control.tag in LabelStudioConfigValidator.LABEL_BASED_CONTROLS:
+            labels = control.findall('Label')
+            if not labels:
+                return False, f"{control.tag} must have at least one <Label> child"
+            
+            # 检查每个标签是否有value
+            for label in labels:
+                if 'value' not in label.attrib:
+                    return False, "Label missing 'value' attribute"
+        
+        return True, None
+    
+    @staticmethod
+    def extract_label_values(xml_string: str) -> Dict[str, List[str]]:
+        """
+        从XML中提取所有标签值
+        
+        Args:
+            xml_string: Label Studio XML配置字符串
+            
+        Returns:
+            字典，键为控件名称，值为标签值列表
+        """
+        result = {}
+        
+        try:
+            root = ET.fromstring(xml_string)
+            controls = [child for child in root if child.tag in LabelStudioConfigValidator.LABEL_BASED_CONTROLS]
+            
+            for control in controls:
+                control_name = control.get('name', 'unknown')
+                labels = control.findall('Label')
+                label_values = [label.get('value', '') for label in labels]
+                result[control_name] = label_values
+                
+        except Exception:
+            pass
+        
+        return result
+    
+    @staticmethod
+    def validate_configuration_json(config: Dict) -> Tuple[bool, Optional[str]]:
+        """
+        验证配置JSON结构
+        
+        Args:
+            config: 配置字典
+            
+        Returns:
+            (是否有效, 错误信息)
+        """
+        # 检查必需字段
+        if 'labels' not in config:
+            return False, "Missing 'labels' field"
+        
+        if 'objects' not in config:
+            return False, "Missing 'objects' field"
+        
+        if not isinstance(config['labels'], list):
+            return False, "'labels' must be an array"
+        
+        if not isinstance(config['objects'], list):
+            return False, "'objects' must be an array"
+        
+        if not config['labels']:
+            return False, "'labels' array cannot be empty"
+        
+        if not config['objects']:
+            return False, "'objects' array cannot be empty"
+        
+        # 验证每个标签定义
+        for idx, label in enumerate(config['labels']):
+            valid, error = LabelStudioConfigValidator._validate_label_definition(label)
+            if not valid:
+                return False, f"Label {idx}: {error}"
+        
+        # 验证每个对象定义
+        for idx, obj in enumerate(config['objects']):
+            valid, error = LabelStudioConfigValidator._validate_object_definition(obj)
+            if not valid:
+                return False, f"Object {idx}: {error}"
+        
+        # 验证toName引用
+        object_names = {obj['name'] for obj in config['objects']}
+        for label in config['labels']:
+            to_name = label.get('toName') or label.get('to_name')
+            from_name = label.get('fromName') or label.get('from_name')
+            if to_name not in object_names:
+                return False, f"Label '{from_name}' references unknown object '{to_name}'"
+        
+        return True, None
+    
+    @staticmethod
+    def _validate_label_definition(label: Dict) -> Tuple[bool, Optional[str]]:
+        """验证标签定义"""
+        # Support both camelCase and snake_case
+        from_name = label.get('fromName') or label.get('from_name')
+        to_name = label.get('toName') or label.get('to_name')
+        label_type = label.get('type')
+        
+        if not from_name:
+            return False, "Missing required field 'fromName'"
+        if not to_name:
+            return False, "Missing required field 'toName'"
+        if not label_type:
+            return False, "Missing required field 'type'"
+        
+        # 检查类型是否支持
+        if label_type not in LabelStudioConfigValidator.CONTROL_TYPES:
+            return False, f"Unsupported control type '{label_type}'"
+        
+        # 检查标签型控件是否有选项或标签
+        if label_type in LabelStudioConfigValidator.LABEL_BASED_CONTROLS:
+            if 'options' not in label and 'labels' not in label:
+                return False, f"{label_type} must have 'options' or 'labels' field"
+        
+        return True, None
+    
+    @staticmethod
+    def _validate_object_definition(obj: Dict) -> Tuple[bool, Optional[str]]:
+        """验证对象定义"""
+        required_fields = ['name', 'type', 'value']
+        
+        for field in required_fields:
+            if field not in obj:
+                return False, f"Missing required field '{field}'"
+        
+        # 检查类型是否支持
+        if obj['type'] not in LabelStudioConfigValidator.OBJECT_TYPES:
+            return False, f"Unsupported object type '{obj['type']}'"
+        
+        # 检查value格式
+        if not obj['value'].startswith('$'):
+            return False, "Object value must start with '$' (e.g., '$image')"
+        
+        return True, None
+
+
+# 使用示例
+if __name__ == "__main__":
+    # 验证XML
+    xml = """<View>
+  <Image name="image" value="$image"/>
+  <Choices name="choice" toName="image" required="true">
+    <Label value="Cat"/>
+    <Label value="Dog"/>
+  </Choices>
+</View>"""
+    
+    valid, error = LabelStudioConfigValidator.validate_xml(xml)
+    print(f"XML Valid: {valid}, Error: {error}")
+    
+    # 验证配置JSON
+    config = {
+        "labels": [
+            {
+                "fromName": "choice",
+                "toName": "image",
+                "type": "Choices",
+                "options": ["Cat", "Dog"],
+                "required": True
+            }
+        ],
+        "objects": [
+            {
+                "name": "image",
+                "type": "Image",
+                "value": "$image"
+            }
+        ]
+    }
+    
+    valid, error = LabelStudioConfigValidator.validate_configuration_json(config)
+    print(f"Config Valid: {valid}, Error: {error}")