feat: add contract template v3 api and legacy oss migration

fastapi_modules/fastapi_leaudit/domian/Dto/contractTemplateDto.py

@@ -0,0 +1,27 @@
+from pydantic import BaseModel, Field
+
+
+class ContractTemplateListQueryDTO(BaseModel):
+    """合同模板列表查询参数。"""
+
+    keyword: str | None = Field(None, description="关键词")
+    category_id: int | None = Field(None, description="分类ID")
+    category_name: str | None = Field(None, description="分类名称")
+    file_format: str | None = Field(None, description="文件格式")
+    is_featured: bool | None = Field(None, description="是否推荐")
+    page: int = Field(1, ge=1, description="页码")
+    page_size: int = Field(12, ge=1, le=200, description="分页大小")
+    sort_by: str = Field("updated_at", description="排序字段")
+    sort_order: str = Field("desc", description="排序方向")
+
+
+class ContractTemplateSearchQueryDTO(BaseModel):
+    """合同模板搜索参数。"""
+
+    q: str = Field(..., min_length=1, description="搜索关键词")
+    category_id: int | None = Field(None, description="分类ID")
+    category_name: str | None = Field(None, description="分类名称")
+    page: int = Field(1, ge=1, description="页码")
+    page_size: int = Field(12, ge=1, le=200, description="分页大小")
+    sort_by: str = Field("updated_at", description="排序字段")
+    sort_order: str = Field("desc", description="排序方向")

fastapi_modules/fastapi_leaudit/domian/vo/contractTemplateVo.py

@@ -0,0 +1,67 @@
+from pydantic import BaseModel, Field
+
+
+class ContractTemplateCategoryVO(BaseModel):
+    """合同模板分类。"""
+
+    id: int = Field(..., description="分类ID")
+    name: str = Field(..., description="分类名称")
+    icon: str | None = Field(None, description="分类图标")
+    description: str | None = Field(None, description="分类描述")
+    sort_order: int = Field(0, description="排序")
+    template_count: int = Field(0, description="分类下模板数量")
+    is_enabled: bool = Field(True, description="是否启用")
+
+
+class ContractTemplateListItemVO(BaseModel):
+    """合同模板列表项。"""
+
+    id: int = Field(..., description="模板ID")
+    template_code: str = Field(..., description="模板编码")
+    title: str = Field(..., description="模板标题")
+    category_id: int = Field(..., description="分类ID")
+    category_name: str | None = Field(None, description="分类名称")
+    category_icon: str | None = Field(None, description="分类图标")
+    description: str | None = Field(None, description="模板简介")
+    file_path: str | None = Field(None, description="原始模板文件路径")
+    pdf_file_path: str | None = Field(None, description="PDF 预览文件路径")
+    file_format: str = Field(..., description="文件格式")
+    is_featured: bool = Field(False, description="是否推荐")
+    created_at: str | None = Field(None, description="创建时间")
+    updated_at: str | None = Field(None, description="更新时间")
+
+
+class ContractTemplatePageVO(BaseModel):
+    """合同模板分页结果。"""
+
+    total: int = Field(..., description="总数")
+    page: int = Field(..., description="当前页")
+    page_size: int = Field(..., description="分页大小")
+    total_pages: int = Field(..., description="总页数")
+    templates: list[ContractTemplateListItemVO] = Field(default_factory=list, description="模板列表")
+
+
+class ContractTemplateDetailVO(ContractTemplateListItemVO):
+    """合同模板详情。"""
+
+    category_description: str | None = Field(None, description="分类描述")
+    placeholder_schema: dict | None = Field(None, description="模板占位符结构")
+
+
+class ContractTemplateSearchCategoryVO(BaseModel):
+    """搜索结果分类统计。"""
+
+    id: int = Field(..., description="分类ID")
+    name: str = Field(..., description="分类名称")
+    search_count: int = Field(0, description="当前关键词命中的模板数")
+
+
+class ContractTemplateSearchResultVO(BaseModel):
+    """合同模板搜索结果。"""
+
+    total: int = Field(..., description="总数")
+    page: int = Field(..., description="当前页")
+    page_size: int = Field(..., description="分页大小")
+    total_pages: int = Field(..., description="总页数")
+    templates: list[ContractTemplateListItemVO] = Field(default_factory=list, description="模板列表")
+    category_stats: list[ContractTemplateSearchCategoryVO] = Field(default_factory=list, description="分类统计")