Add storyboard scene ref and video prompt contract

yaoai-comic-studio/yaoai-api/src/main/java/com/yaoai/api/dto/ai/StoryboardDTO.java

@@ -29,6 +29,8 @@ public class StoryboardDTO {
     private Integer durationSeconds;
     private String startFramePrompt;
     private String motionScript;
+    private String sceneRef;
+    private String videoPrompt;
     private String notes;
     private String status;
     private LocalDateTime createdAt;
@@ -55,6 +57,8 @@ public class StoryboardDTO {
         dto.setDurationSeconds(s.getDurationSeconds());
         dto.setStartFramePrompt(s.getStartFramePrompt());
         dto.setMotionScript(s.getMotionScript());
+        dto.setSceneRef(s.getSceneRef());
+        dto.setVideoPrompt(s.getVideoPrompt());
         dto.setNotes(s.getNotes());
         dto.setStatus(s.getStatus());
         dto.setCreatedAt(s.getCreatedAt());

yaoai-comic-studio/yaoai-bootstrap/src/main/resources/db/migration/V17__storyboard_scene_ref_video_prompt.sql

+ALTER TABLE storyboards
+    ADD COLUMN scene_ref VARCHAR(128) DEFAULT NULL COMMENT 'Storyboard scene reference',
+    ADD COLUMN video_prompt LONGTEXT DEFAULT NULL COMMENT 'Expanded prompt for video generation';

yaoai-comic-studio/yaoai-bootstrap/src/test/java/com/yaoai/pipeline/service/impl/StoryboardPipelineServiceImplTest.java

+package com.yaoai.pipeline.service.impl;
+
+import com.yaoai.api.dto.ai.StoryboardDTO;
+import com.yaoai.domain.entity.Storyboard;
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+class StoryboardPipelineServiceImplTest {
+
+    @Test
+    void storyboardDtoFromExposesSceneRefAndVideoPrompt() {
+        Storyboard storyboard = new Storyboard();
+        storyboard.setSceneRef("scene-ref-001");
+        storyboard.setVideoPrompt("A slow dolly-in across the moonlit alley.");
+
+        StoryboardDTO dto = StoryboardDTO.from(storyboard);
+
+        assertEquals("scene-ref-001", dto.getSceneRef());
+        assertEquals("A slow dolly-in across the moonlit alley.", dto.getVideoPrompt());
+    }
+}

yaoai-comic-studio/yaoai-domain/src/main/java/com/yaoai/domain/entity/Storyboard.java

@@ -34,6 +34,8 @@ public class Storyboard {
     private String motionScript;
     private String startFramePrompt;
     private String endFramePrompt;
+    private String sceneRef;
+    private String videoPrompt;
     private String notes;
 
     /** V16：分镜上落地的素材选择（编辑态记忆） */

yaoai-comic-studio/yaoai-domain/src/main/java/com/yaoai/domain/mapper/StoryboardMapper.java

@@ -23,6 +23,10 @@ public interface StoryboardMapper extends BaseMapper<Storyboard> {
     @Select("SELECT COUNT(*) FROM storyboards WHERE episode_id=#{episodeId} AND tenant_id=#{tenantId}")
     int countByEpisode(Long episodeId, Long tenantId);
 
+    @Select("SELECT * FROM storyboards WHERE episode_id=#{episodeId} AND tenant_id=#{tenantId} " +
+            "AND (video_prompt IS NULL OR TRIM(video_prompt) = '') ORDER BY sequence_num ASC")
+    List<Storyboard> findMissingVideoPromptByEpisode(Long episodeId, Long tenantId);
+
     @Update("UPDATE storyboards SET sequence_num=#{seq} WHERE id=#{id} AND tenant_id=#{tenantId}")
     int updateSequence(Long id, int seq, Long tenantId);
 }