""" Video API Schemas 영상 생성 관련 Pydantic 스키마를 정의합니다. """ from datetime import datetime from typing import Any, Dict, List, Literal, Optional from pydantic import BaseModel, ConfigDict, Field # ============================================================================= # Response Schemas # ============================================================================= class GenerateVideoResponse(BaseModel): """영상 생성 응답 스키마 Usage: GET /video/generate/{task_id} Returns the task IDs for tracking video generation. """ model_config = ConfigDict( json_schema_extra={ "example": { "success": True, "task_id": "0694b716-dbff-7219-8000-d08cb5fce431", "creatomate_render_id": "render-id-123456", "message": "영상 생성 요청이 접수되었습니다. creatomate_render_id로 상태를 조회하세요.", "error_message": None, } } ) success: bool = Field(..., description="요청 성공 여부") status: Optional[str] = Field(None, description="처리 상태 (subtitle_pending: 자막 미완료, completed: 정상 접수)") task_id: Optional[str] = Field(None, description="내부 작업 ID (Project task_id)") creatomate_render_id: Optional[str] = Field(None, description="Creatomate 렌더 ID") message: str = Field(..., description="응답 메시지") error_message: Optional[str] = Field(None, description="에러 메시지 (실패 시)") class VideoRenderData(BaseModel): """Creatomate 렌더링 결과 데이터""" id: Optional[str] = Field(None, description="렌더 ID") status: Optional[str] = Field(None, description="렌더 상태") url: Optional[str] = Field(None, description="영상 URL") snapshot_url: Optional[str] = Field(None, description="스냅샷 URL") video_id: Optional[int] = Field(None, description="Video id(DB)") class PollingVideoResponse(BaseModel): """영상 생성 상태 조회 응답 스키마 Usage: GET /video/status/{creatomate_render_id} Creatomate API 작업 상태를 조회합니다. Note: 상태 값: - planned: 예약됨 - waiting: 대기 중 - transcribing: 트랜스크립션 중 - rendering: 렌더링 중 - succeeded: 성공 - failed: 실패 Example Response (Success): { "success": true, "status": "succeeded", "message": "영상 생성이 완료되었습니다.", "render_data": { "id": "render-id", "status": "succeeded", "url": "https://...", "snapshot_url": "https://..." }, "raw_response": {...}, "error_message": null } """ success: bool = Field(..., description="조회 성공 여부") status: Optional[str] = Field( None, description="작업 상태 (planned, waiting, rendering, succeeded, failed)" ) message: str = Field(..., description="상태 메시지") render_data: Optional[VideoRenderData] = Field(None, description="렌더링 결과 데이터") raw_response: Optional[Dict[str, Any]] = Field(None, description="Creatomate API 원본 응답") error_message: Optional[str] = Field(None, description="에러 메시지 (실패 시)") class DownloadVideoResponse(BaseModel): """영상 다운로드 응답 스키마 Usage: GET /video/download/{task_id} Polls for video completion and returns project info with video URL. Note: 상태 값: - processing: 영상 생성 진행 중 (result_movie_url은 null) - completed: 영상 생성 완료 (result_movie_url 포함) - failed: 영상 생성 실패 - not_found: task_id에 해당하는 Video 없음 - error: 조회 중 오류 발생 Example Response (Completed): { "success": true, "status": "completed", "message": "영상 다운로드가 완료되었습니다.", "store_name": "스테이 머뭄", "region": "군산", "task_id": "019123ab-cdef-7890-abcd-ef1234567890", "result_movie_url": "http://localhost:8000/media/2025-01-15/video.mp4", "created_at": "2025-01-15T12:00:00", "error_message": null } """ success: bool = Field(..., description="다운로드 성공 여부") status: str = Field(..., description="처리 상태 (processing, completed, failed, not_found, error)") message: str = Field(..., description="응답 메시지") store_name: Optional[str] = Field(None, description="업체명") region: Optional[str] = Field(None, description="지역명") task_id: Optional[str] = Field(None, description="작업 고유 식별자") result_movie_url: Optional[str] = Field(None, description="영상 결과 URL") created_at: Optional[datetime] = Field(None, description="생성 일시") error_message: Optional[str] = Field(None, description="에러 메시지 (실패 시)") class VideoListItem(BaseModel): """영상 목록 아이템 스키마 Usage: GET /videos 응답의 개별 영상 정보 Example: { "video_id": 1, "store_name": "스테이 머뭄", "region": "군산", "task_id": "019123ab-cdef-7890-abcd-ef1234567890", "result_movie_url": "http://localhost:8000/media/2025-01-15/video.mp4", "poster_url": "http://localhost:8000/media/2025-01-15/video.jpg", "created_at": "2025-01-15T12:00:00" } """ # ⚠️ `video_id` 는 type 안에서만 유일하다 — `video.id` 와 `ssul_content.id` 는 # 각각 1부터 시작하는 독립 시퀀스다. 식별·삭제·상세 열기 모두 # **`(type, video_id)` 쌍**으로 다뤄야 한다. # 특히 `DELETE /archive/videos/{id}` 는 `Video.id` 로 지우므로, # 썰박스 항목의 id 를 그대로 넘기면 **엉뚱한 ADO2 영상이 삭제된다.** type: Literal["video", "ssul", "p2v_video", "p2v_poster"] = Field( default="video", description="콘텐츠 종류 (video: ADO2 영상, ssul: 썰박스, " "p2v_video: 무빙 포스터, p2v_poster: 포스터 스타일링 — 이미지라 로 그릴 것)", ) video_id: int = Field(..., description="콘텐츠 고유 ID (type 안에서만 유일)") store_name: Optional[str] = Field(None, description="업체명") region: Optional[str] = Field(None, description="지역명") task_id: str = Field( default="", description="작업 고유 식별자 (ADO2 전용. 썰박스는 개념이 없어 빈 문자열)", ) result_movie_url: Optional[str] = Field(None, description="영상 결과 URL") poster_url: Optional[str] = Field(None, description="영상 첫 프레임 포스터 이미지 URL") title: Optional[str] = Field(None, description="SNS 업로드 제목") description: Optional[str] = Field(None, description="SNS 업로드 설명") hashtags: Optional[List[str]] = Field(None, description="SNS 해시태그 목록") created_at: Optional[datetime] = Field(None, description="생성 일시") like_count: int = Field(0, description="좋아요 수") comment_count: int = Field(0, description="댓글 수 (대댓글 포함)") is_liked_by_me: bool = Field( False, description="현재 로그인 사용자가 좋아요를 눌렀는지", ) class VideoThumbnailItem(BaseModel): """ADO2 콘텐츠 갤러리용 최소 영상 정보 (썸네일 표시 + 상세 페이지 이동용) Usage: GET /video/all 응답의 개별 영상 정보 """ # ⚠️ `video_id` 는 종류 안에서만 유일하다. `video.id` 와 `ssul_content.id` 가 # **둘 다 1부터 시작**하므로 식별자는 반드시 `(type, video_id)` 쌍으로 다뤄야 한다. # 한 곳이라도 id 만 쓰면 다른 종류의 콘텐츠가 열린다. type: Literal["video", "ssul", "p2v_video", "p2v_poster"] = Field( default="video", description="콘텐츠 종류 (video: ADO2 영상, ssul: 썰박스, p2v_video: 무빙 포스터, " "p2v_poster: 포스터 스타일링 — 이미지라 로 그릴 것). video_id 와 쌍으로 식별한다", ) video_id: int = Field(..., description="콘텐츠 고유 ID (type 안에서만 유일)") store_name: str = Field(..., description="업체명 (P2V 는 행사명/포스터명)") result_movie_url: str = Field(..., description="영상 URL (p2v_poster 는 이미지 URL)") poster_url: Optional[str] = Field(None, description="영상 첫 프레임 포스터 이미지 URL (썸네일 표시용)") title: Optional[str] = Field(None, description="SNS 업로드 제목") description: Optional[str] = Field(None, description="SNS 업로드 설명") created_at: datetime = Field(..., description="생성 일시") like_count: int = Field(..., description="좋아요 수") is_liked_by_me: bool = Field(..., description="현재 로그인 사용자가 좋아요를 눌렀는지 (비로그인은 항상 false)") comment_count: int = Field(..., description="댓글 수 (대댓글 포함)") official_site_url: Optional[str] = Field( None, description="업체 공식 링크 (플레이스 홈페이지 항목 우선, 없으면 크롤링 소스 URL; 직접 입력 생성 영상만 null)", ) class VideoDetailResponse(BaseModel): """단일 영상 상세 응답 Usage: GET /video/{video_id} """ video_id: int = Field(..., description="영상 고유 ID") result_movie_url: str = Field(..., description="영상 URL") poster_url: Optional[str] = Field(None, description="영상 첫 프레임 포스터 이미지 URL") store_name: Optional[str] = Field(None, description="업체명") region: Optional[str] = Field(None, description="지역명") title: Optional[str] = Field(None, description="SNS 업로드 제목") description: Optional[str] = Field(None, description="SNS 업로드 설명") created_at: datetime = Field(..., description="생성 일시") like_count: int = Field(..., description="좋아요 수") is_liked_by_me: bool = Field(..., description="현재 로그인 사용자가 좋아요를 눌렀는지 (비로그인은 항상 false)") official_site_url: Optional[str] = Field( None, description="업체 공식 링크 (플레이스 홈페이지 항목 우선, 없으면 크롤링 소스 URL; 직접 입력 생성 영상만 null)", ) class LikeToggleResponse(BaseModel): """좋아요 토글 응답 Usage: POST /video/{video_id}/like """ video_id: int = Field(..., description="영상 고유 ID") is_liked: bool = Field(..., description="토글 후 상태 (true=좋아요 누름, false=취소됨)") like_count: int = Field(..., description="토글 후 전체 좋아요 수")