refactor(wave112): 抽离intro_outro_config领域模型 + 52单测 (#998)

apps/worker/video_processing/intro_outro_engine.py

@@ -11,129 +11,22 @@ from __future__ import annotations
 
 import logging
 import subprocess
-from dataclasses import dataclass
 from pathlib import Path
-from typing import Any
 
+from packages.domain.intro_outro_config import (  # noqa: F401 — 向后兼容
+    INTRO_OUTRO_TYPE_FOLLOW,
+    INTRO_OUTRO_TYPE_NONE,
+    INTRO_OUTRO_TYPE_TEXT,
+    INTRO_OUTRO_TYPE_VIDEO,
+    TRANSITION_FADE,
+    IntroOutroConfig,
+)
 from video_processing.ffmpeg_utils import FFMPEG_BIN, run_ffmpeg
 
 logger = logging.getLogger(__name__)
 
 
-@dataclass
-class IntroOutroConfig:
-    """片头片尾配置.
-
-    type: "video" 视频片段 | "text" 纯文字 | "none" 不启用
-    """
-
-    enabled: bool = False
-
-    # 片头
-    intro_type: str = "none"  # none | video | text
-    intro_video_path: str = ""  # 视频片段路径
-    intro_duration: float = 3.0  # 片头时长（秒）
-
-    # 文字片头配置
-    intro_background: str = "#000000"  # 背景色
-    intro_title: str = ""
-    intro_subtitle: str = ""
-    intro_title_color: str = "white"
-    intro_title_size: int = 48
-    intro_subtitle_color: str = "gray"
-    intro_subtitle_size: int = 24
-
-    # 片尾
-    outro_type: str = "none"  # none | video | text | follow
-    outro_video_path: str = ""  # 视频片段路径
-    outro_duration: float = 3.0  # 片尾时长（秒）
-
-    # 文字片尾配置
-    outro_background: str = "#000000"
-    outro_title: str = "感谢观看"
-    outro_subtitle: str = "点赞关注不迷路"
-    outro_title_color: str = "white"
-    outro_title_size: int = 48
-    outro_subtitle_color: str = "gray"
-    outro_subtitle_size: int = 24
-
-    # 转场
-    transition_effect: str = "fade"
-    transition_duration: float = 0.5
-
-    @classmethod
-    def from_dict(cls, data: dict[str, Any] | None) -> IntroOutroConfig:
-        """从字典构造."""
-        if not data:
-            return cls()
-
-        enabled = data.get("enabled", False)
-        if not enabled:
-            return cls()
-
-        intro = data.get("intro", {}) or {}
-        outro = data.get("outro", {}) or {}
-
-        return cls(
-            enabled=True,
-            # 片头
-            intro_type=str(intro.get("type", "none")),
-            intro_video_path=str(intro.get("video_path", intro.get("video", "")) or ""),
-            intro_duration=float(intro.get("duration", 3.0)),
-            intro_background=str(intro.get("background", "#000000")),
-            intro_title=str(intro.get("title", "") or ""),
-            intro_subtitle=str(intro.get("subtitle", "") or ""),
-            intro_title_color=str(intro.get("title_color", "white")),
-            intro_title_size=int(intro.get("title_size", 48)),
-            intro_subtitle_color=str(intro.get("subtitle_color", "gray")),
-            intro_subtitle_size=int(intro.get("subtitle_size", 24)),
-            # 片尾
-            outro_type=str(outro.get("type", "none")),
-            outro_video_path=str(outro.get("video_path", outro.get("video", "")) or ""),
-            outro_duration=float(outro.get("duration", 3.0)),
-            outro_background=str(outro.get("background", "#000000")),
-            outro_title=str(outro.get("title", "感谢观看") or "感谢观看"),
-            outro_subtitle=str(outro.get("subtitle", "点赞关注不迷路") or "点赞关注不迷路"),
-            outro_title_color=str(outro.get("title_color", "white")),
-            outro_title_size=int(outro.get("title_size", 48)),
-            outro_subtitle_color=str(outro.get("subtitle_color", "gray")),
-            outro_subtitle_size=int(outro.get("subtitle_size", 24)),
-            # 转场
-            transition_effect=str(data.get("transition", "fade")),
-            transition_duration=float(data.get("transition_duration", 0.5)),
-        )
-
-    @property
-    def has_intro(self) -> bool:
-        """是否有片头."""
-        return self.enabled and self.intro_type in ("video", "text")
-
-    @property
-    def has_outro(self) -> bool:
-        """是否有片尾."""
-        return self.enabled and self.outro_type in ("video", "text", "follow")
-
-    def validate(self) -> tuple[bool, str]:
-        """校验配置."""
-        if not self.enabled:
-            return True, ""
-
-        if self.intro_type == "video" and not self.intro_video_path:
-            return False, "视频片头缺少 video_path"
-        if self.intro_type == "text" and not self.intro_title:
-            return False, "文字片头缺少 title"
-
-        if self.outro_type == "video" and not self.outro_video_path:
-            return False, "视频片尾缺少 video_path"
-        if self.outro_type in ("text", "follow") and not self.outro_title:
-            return False, "文字片尾缺少 title"
-
-        if self.intro_duration <= 0:
-            return False, "片头时长必须大于 0"
-        if self.outro_duration <= 0:
-            return False, "片尾时长必须大于 0"
-
-        return True, ""
+# ── 片头片尾引擎 ──────────────────────────────────────────────────────────────
 
 
 class IntroOutroEngine: