xiaoxia-saas/apps/api/app/schemas/template.py

"""Template API schemas（精简版：仅保留列表接口 + 默认模板自动兜底所需字段）.

前端 PR#1911 删除 my-templates / editing-planner / templates 管理页后，
模板 CRUD / 分类 / 标签 / 收藏 / 复制 / 校验 / 使用统计等端点全部下线，
对应 Request/Response 模型也一并清理。
"""

from __future__ import annotations

from datetime import datetime
from typing import Any, Optional

from pydantic import BaseModel, Field

# ── Segment ──


class SegmentResponse(BaseModel):
    id: str
    template_id: str
    segment_order: int
    duration_min: float
    duration_max: float
    material_type: Optional[str] = None
    created_at: datetime
    updated_at: datetime


class SegmentRequest(BaseModel):
    segment_order: int
    duration_min: float
    duration_max: float
    material_type: Optional[str] = None


# ── Template Response ──


class TemplateResponse(BaseModel):
    id: str
    user_id: str
    name: str
    mode: str
    category: str = ""
    tags: list[str] = Field(default_factory=list)
    title_config: dict[str, Any] = Field(default_factory=dict)
    subtitle_config: dict[str, Any] = Field(default_factory=dict)
    bgm_config: dict[str, Any] = Field(default_factory=dict)
    estimated_duration: float = 0.0
    segments: list[SegmentResponse] = Field(default_factory=list)
    is_active: bool = True
    is_favorite: bool = False
    usage_count: int = 0
    created_at: datetime
    updated_at: datetime


class ListTemplatesResponse(BaseModel):
    items: list[TemplateResponse]
    total: int = 0


# ── Template Request（保留给内部 _get_or_create_default_template_id 兜底创建默认模板使用）──


class CreateTemplateRequest(BaseModel):
    name: str
    mode: str
    category: str = ""
    tags: list[str] = Field(default_factory=list)
    title_config: dict[str, Any] = Field(default_factory=dict)
    subtitle_config: dict[str, Any] = Field(default_factory=dict)
    bgm_config: dict[str, Any] = Field(default_factory=dict)
    estimated_duration: float = 0.0
    segments: list[SegmentRequest] = Field(default_factory=list)


class GenerateWarningResponse(BaseModel):
    """兼容老 import（如校验逻辑内部复用）；模板管理页已下线，可按需进一步清理。"""

    code: str
    message: str
    details: dict[str, Any] = Field(default_factory=dict)