后端生成闸+多项修复;前端全站更新;QA 审计与报告

后端:
- 新增 celery_health 生成前置闸——无 worker 在线时图片/视频生成入口
  一律 503,防"提交到 ARK 后无人轮询、结果悬空+额度冻结"的数据丢失
- 拼接导出:帧率跟随源众数、字幕逐句重映射、原声/BGM 混音修复
- 资金核算审计脚本 + genesis 账目回填 + 滞留预留清理命令
- 接入 yunqi provider 与豆包 TTS 模型(catalog/migrations/bootstrap 命令)

前端:全站页面更新(pipeline/library/products/projects/team/account 等),
新增共享 pager 分页组件

QA:刷新 function-audit 全量输出,新增 full-qa 报告
文档:BP 产品介绍资料、design/CLAUDE.md

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

core/backend/apps/projects/serializers.py

@@ -1,3 +1,5 @@
+import uuid
+
 from rest_framework import serializers
 
 from apps.assets.serializers import AssetFileSerializer
@@ -40,10 +42,11 @@ class ProjectStageSerializer(serializers.ModelSerializer):
 class VideoSegmentSerializer(serializers.ModelSerializer):
     adopted_asset = serializers.SerializerMethodField()
     adopted_asset_url = serializers.SerializerMethodField()
+    versions = serializers.SerializerMethodField()
 
     class Meta:
         model = VideoSegment
-        fields = ["id", "sort_order", "target_duration_seconds", "status", "error_message", "adopted_version", "adopted_asset", "adopted_asset_url"]
+        fields = ["id", "sort_order", "target_duration_seconds", "status", "error_message", "adopted_version", "adopted_asset", "adopted_asset_url", "versions"]
         read_only_fields = ["id", "sort_order", "target_duration_seconds", "status", "error_message", "adopted_version"]
 
     def get_adopted_asset(self, obj):
@@ -55,6 +58,21 @@ class VideoSegmentSerializer(serializers.ModelSerializer):
         version = obj.adopted_version
         return _asset_preview_url(version.asset) if version is not None else ""
 
+    def get_versions(self, obj):
+        # 视频详情弹窗:历史版本(倒序,带可播放 URL)。模型无 Meta.ordering,这里按 created_at 排
+        versions = sorted(obj.versions.all(), key=lambda v: (v.created_at is None, v.created_at), reverse=True)
+        return [
+            {
+                "id": str(v.id),
+                "asset": str(v.asset_id) if v.asset_id else None,
+                "asset_url": _asset_preview_url(v.asset) if v.asset_id else "",
+                "prompt": v.prompt,
+                "is_adopted": v.is_adopted,
+                "created_at": v.created_at.isoformat() if v.created_at else "",
+            }
+            for v in versions
+        ]
+
 
 class BaseAssetGroupSerializer(serializers.ModelSerializer):
     candidate_assets = serializers.PrimaryKeyRelatedField(many=True, read_only=True)
@@ -167,11 +185,37 @@ class TimelineSerializer(serializers.ModelSerializer):
     export_jobs = TimelineExportJobSerializer(many=True, read_only=True)
     subtitle_tracks = SubtitleTrackSerializer(many=True, read_only=True)
     bgm_tracks = BgmTrackSerializer(many=True, read_only=True)
+    voiceover = serializers.SerializerMethodField()
 
     class Meta:
         model = Timeline
-        fields = ["id", "name", "aspect_ratio", "resolution", "duration_seconds", "metadata", "clips", "export_jobs", "subtitle_tracks", "bgm_tracks"]
-        read_only_fields = ["id", "clips", "export_jobs", "subtitle_tracks", "bgm_tracks"]
+        fields = ["id", "name", "aspect_ratio", "resolution", "duration_seconds", "metadata", "voiceover", "clips", "export_jobs", "subtitle_tracks", "bgm_tracks"]
+        read_only_fields = ["id", "voiceover", "clips", "export_jobs", "subtitle_tracks", "bgm_tracks"]
+
+    def get_voiceover(self, obj):
+        # 旁白配音映射(metadata.voiceover)+ 每段新鲜的可播放 URL(TOS 签名 URL 会过期,不能存死)
+        vo = (obj.metadata or {}).get("voiceover")
+        if not isinstance(vo, dict) or not vo.get("items"):
+            return None
+        from apps.assets.models import Asset
+
+        ids = []
+        for item in vo["items"]:
+            try:
+                ids.append(uuid.UUID(str(item.get("asset"))))
+            except (TypeError, ValueError):
+                continue
+        assets = {str(a.id): a for a in Asset.objects.filter(id__in=ids).prefetch_related("files")}
+        items = []
+        for item in vo["items"]:
+            asset = assets.get(str(item.get("asset")))
+            items.append({**item, "asset_url": _asset_preview_url(asset)})
+        return {
+            "enabled": bool(vo.get("enabled")),
+            "voice_type": str(vo.get("voice_type") or ""),
+            "speed_ratio": vo.get("speed_ratio", 1.0),
+            "items": items,
+        }
 
 
 class ExportJobSerializer(serializers.ModelSerializer):