feat(viral-video): 三步独立流程接入真实后端API（替换mock，对接analyze-images/generate-copy/confirm-copy） #2122
Merged
xiaoxia
merged 1 commits from 2026-10-01 12:25:04 +08:00
feat/2041-real-3step-api into develop
1 Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
 saas前端工程师
|
235d3685c6 |
feat(viral-video): 三步独立流程接入真实后端API（替换mock）
CI/CD Pipeline / Dedup Check - skip PR tests when covered by push pipeline (pull_request) Successful in 3s
CI/CD Pipeline / Check push changed paths (pull_request) Has been skipped
CI/CD Pipeline / Check if frontend-only change (pull_request) Successful in 3s
CI/CD Pipeline / Integration Tests (pull_request) Has been skipped
CI/CD Pipeline / Unit Tests (pull_request) Has been skipped
CI/CD Pipeline / PR Build API Image (pull_request) Has been skipped
CI/CD Pipeline / PR Build Worker Image (pull_request) Has been skipped
CI/CD Pipeline / Build Staging API Image (pull_request) Has been skipped
CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped
CI/CD Pipeline / Build Staging Web Image (pull_request) Has been skipped
ACR Cleanup / ACR Image Cleanup (pull_request_target) Successful in 47s
CI/CD Pipeline / Retag skipped Staging API Image (pull_request) Has been skipped
CI/CD Pipeline / Retag skipped Staging Web Image (pull_request) Has been skipped
CI/CD Pipeline / Retag skipped Staging Worker Image (pull_request) Has been skipped
Preview Cleanup / Cleanup Preview Environment (pull_request) Successful in 1m19s
Preview Deploy / Deploy Preview Environment (pull_request) Successful in 2m32s
CI/CD Pipeline / PR Build Web Image (pull_request) Successful in 1m55s
CI/CD Pipeline / Frontend Lint (pull_request) Successful in 2m5s
PR Automation / Auto Approve on CI Green (pull_request) Failing after 2m53s
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped
PR Automation / Auto Merge on CI Green + Approved (pull_request) Has been skipped
CI/CD Pipeline / Staging E2E Tests (pull_request) Has been skipped
CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been skipped
CI/CD Pipeline / ACR Image Cleanup (pull_request) Has been skipped
CI/CD Pipeline / Frontend Unit Tests (pull_request) Successful in 4m34s
CI/CD Pipeline / Validate - Python (mypy + alembic) (pull_request) Successful in 5m7s
CI/CD Pipeline / Validate - Style (pull_request) Successful in 6m48s
AI Code Review / AI Code Review (pull_request) Successful in 7m20s
CI/CD Pipeline / Validate - Security (pull_request) Successful in 11m35s
CI/CD Pipeline / Build Production API Image (pull_request) Has been skipped
CI/CD Pipeline / Build Production Web Image (pull_request) Has been skipped
CI/CD Pipeline / Build Production Worker Image (pull_request) Has been skipped
CI/CD Pipeline / Deploy Production (pull_request) Has been skipped
CI/CD Pipeline / Canary Release to Production (pull_request) Has been skipped
CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped
CI/CD Pipeline / CI Gate (pull_request) Successful in 3s
后端PR#2117已上线三步独立端点，前端替换原先的mockImageAnalysis/mockGenerateCopy： 1. STEP1「🔍 分析图片」： - 改为调用 POST /viral-video/analyze-images，入参 images/reference_video_url/style_strength - 返回 ViralVideoJob，立刻保存 jobId 并启动轮询（之前轮询只在视频生成阶段启用，现在从STEP1开始贯穿三步） - 删除 mockImageAnalysis 客户端假数据 2. STEP2「✍️ 生成文案」： - 改为调用 POST /viral-video/{id}/generate-copy，入参 industry/target_customer/viral_structure/marketing_purpose/bgm_preference/duration/fusion_level/user_copy_text/style_strength - AI全写/AI润色档位不传user_copy_text；按我的话来档位传textarea内容 - 返回 job 包含 copy_result，轮询到 status=copy_generated 时自动把 copy_result.final_copy/title 同步进generatedCopy/generatedTitle并切换到step2_copy_ready - 删除 mockGenerateCopy 客户端假数据 3. STEP2「🎬 确认文案并生成视频」→ 合并触发： - handleConfirmCopy 不再只切本地状态，改为调用 POST /viral-video/{id}/confirm-copy - 用户未修改文案时不传 edited_copy（后端用AI生成的final_copy）；用户编辑过则传 edited_copy - 接口返回后job进入running→TTS→Seedance→ffmpeg→upload全流程，轮询到status=completed自动切换step3_done - 不再需要单独再点「开始生成视频」按钮，但保留STEP3的按钮作为重试/兜底入口（有jobId+文案时走confirm-copy，否则降级到旧/generate接口） 4. 轮询 onPollUpdate 升级： - 识别新状态 image_analyzed→step1_done、copy_generated→step2_copy_ready - running态按progress_stage细分：image/video_analysis→step1_analyzing、intent/copy/storyboard/review→step2_generating、tts/bgm/rendering/musetalk/uploading→step3_generating - 自动同步 job.image_analysis 和 job.copy_result 到本地imageAnalysis/generatedCopy/generatedTitle，避免本地state与服务端不同步 - failed态按阶段区分copyError/videoError 5. 旧链路兼容： - /generate 和 /{id}/confirm-intent 端点保留不删，handleGenerateVideo 兜底路径继续使用旧/generate（兼容旧任务/失败重试/没有jobId的降级场景） - retryViralVideo 逻辑不变 - GET /{id} 已返回image_analysis/copy_result字段，类型定义已在types.ts对齐 tsc/eslint/prettier/vite build 全绿。 |