178 lines
7.8 KiB
Python
178 lines
7.8 KiB
Python
"""
|
|
소셜 업로드 관련 Pydantic 스키마
|
|
"""
|
|
|
|
from datetime import datetime
|
|
from typing import Any, Literal, Optional
|
|
|
|
from pydantic import BaseModel, ConfigDict, Field
|
|
|
|
from app.social.constants import PrivacyStatus, UploadStatus
|
|
|
|
|
|
class SocialUploadRequest(BaseModel):
|
|
"""소셜 업로드 요청"""
|
|
|
|
# ⚠️ video_id 는 content_type 안에서만 유일하다 — video.id 와 ssul_content.id 는
|
|
# 각각 1부터 시작하는 독립 시퀀스라 값이 겹친다. content_type 없이 썰박스 id 를
|
|
# 보내면 **id 가 겹치는 남의 ADO2 영상이 업로드된다.**
|
|
content_type: Literal["video", "ssul"] = Field(
|
|
default="video",
|
|
description="콘텐츠 종류 (video: ADO2 영상, ssul: 썰박스)",
|
|
)
|
|
video_id: int = Field(..., description="업로드할 콘텐츠 ID (content_type 안에서만 유일)")
|
|
social_account_id: int = Field(..., description="업로드할 소셜 계정 ID (연동 계정 목록의 id)")
|
|
title: str = Field(..., min_length=1, max_length=100, description="영상 제목")
|
|
description: Optional[str] = Field(
|
|
None, max_length=5000, description="영상 설명"
|
|
)
|
|
tags: Optional[list[str]] = Field(None, description="태그 목록 (쉼표로 구분된 문자열도 가능)")
|
|
privacy_status: PrivacyStatus = Field(
|
|
default=PrivacyStatus.PRIVATE, description="공개 상태 (public, unlisted, private)"
|
|
)
|
|
scheduled_at: Optional[datetime] = Field(
|
|
None, description="예약 게시 시간 (없으면 즉시 게시)"
|
|
)
|
|
platform_options: Optional[dict[str, Any]] = Field(
|
|
None, description="플랫폼별 추가 옵션"
|
|
)
|
|
|
|
model_config = ConfigDict(
|
|
json_schema_extra={
|
|
"example": {
|
|
"video_id": 123,
|
|
"social_account_id": 1,
|
|
"title": "도그앤조이 애견펜션 2026.02.02",
|
|
"description": "영상 설명입니다.",
|
|
"tags": ["여행", "vlog", "애견펜션"],
|
|
"privacy_status": "public",
|
|
"scheduled_at": "2026-02-02T15:00:00",
|
|
"platform_options": {
|
|
"category_id": "22",
|
|
},
|
|
}
|
|
}
|
|
)
|
|
|
|
|
|
class SocialUploadResponse(BaseModel):
|
|
"""소셜 업로드 요청 응답"""
|
|
|
|
success: bool = Field(..., description="요청 성공 여부")
|
|
upload_id: int = Field(..., description="업로드 작업 ID")
|
|
platform: str = Field(..., description="플랫폼명")
|
|
status: str = Field(..., description="업로드 상태")
|
|
message: str = Field(..., description="응답 메시지")
|
|
scheduled_at: Optional[datetime] = Field(None, description="예약 시간 (예약 업로드 충돌 시 반환)")
|
|
|
|
|
|
model_config = ConfigDict(
|
|
json_schema_extra={
|
|
"example": {
|
|
"success": True,
|
|
"upload_id": 456,
|
|
"platform": "youtube",
|
|
"status": "pending",
|
|
"message": "업로드 요청이 접수되었습니다.",
|
|
"scheduled_at": "2026-02-02T15:00:00",
|
|
}
|
|
}
|
|
)
|
|
|
|
|
|
class SocialUploadStatusResponse(BaseModel):
|
|
"""업로드 상태 조회 응답"""
|
|
|
|
upload_id: int = Field(..., description="업로드 작업 ID")
|
|
# 썰박스 업로드면 video_id 가 None 이고 content_id 가 채워진다 (정확히 하나만)
|
|
video_id: Optional[int] = Field(None, description="ADO2 영상 ID (썰박스면 None)")
|
|
content_id: Optional[int] = Field(None, description="썰박스 콘텐츠 ID (ADO2 면 None)")
|
|
social_account_id: int = Field(..., description="소셜 계정 ID")
|
|
upload_seq: int = Field(..., description="업로드 순번 (동일 영상+채널 조합 내 순번)")
|
|
platform: str = Field(..., description="플랫폼명")
|
|
status: UploadStatus = Field(..., description="업로드 상태")
|
|
upload_progress: int = Field(..., description="업로드 진행률 (0-100)")
|
|
title: str = Field(..., description="영상 제목")
|
|
platform_video_id: Optional[str] = Field(None, description="플랫폼 영상 ID")
|
|
platform_url: Optional[str] = Field(None, description="플랫폼 영상 URL")
|
|
error_message: Optional[str] = Field(None, description="에러 메시지")
|
|
retry_count: int = Field(default=0, description="재시도 횟수")
|
|
scheduled_at: Optional[datetime] = Field(None, description="예약 게시 시간 (있으면 예약 업로드)")
|
|
created_at: datetime = Field(..., description="생성 일시")
|
|
uploaded_at: Optional[datetime] = Field(None, description="업로드 완료 일시")
|
|
|
|
model_config = ConfigDict(
|
|
from_attributes=True,
|
|
json_schema_extra={
|
|
"example": {
|
|
"upload_id": 456,
|
|
"video_id": 123,
|
|
"social_account_id": 1,
|
|
"upload_seq": 2,
|
|
"platform": "youtube",
|
|
"status": "completed",
|
|
"upload_progress": 100,
|
|
"title": "나의 첫 영상",
|
|
"platform_video_id": "dQw4w9WgXcQ",
|
|
"platform_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
|
|
"error_message": None,
|
|
"retry_count": 0,
|
|
"created_at": "2024-01-15T12:00:00",
|
|
"uploaded_at": "2024-01-15T12:05:00",
|
|
}
|
|
}
|
|
)
|
|
|
|
|
|
class SocialUploadHistoryItem(BaseModel):
|
|
"""업로드 이력 아이템"""
|
|
|
|
upload_id: int = Field(..., description="업로드 작업 ID")
|
|
# 썰박스 업로드면 video_id 가 None 이고 content_id 가 채워진다 (정확히 하나만)
|
|
video_id: Optional[int] = Field(None, description="ADO2 영상 ID (썰박스면 None)")
|
|
content_id: Optional[int] = Field(None, description="썰박스 콘텐츠 ID (ADO2 면 None)")
|
|
social_account_id: int = Field(..., description="소셜 계정 ID")
|
|
upload_seq: int = Field(..., description="업로드 순번 (동일 영상+채널 조합 내 순번)")
|
|
platform: str = Field(..., description="플랫폼명")
|
|
status: str = Field(..., description="업로드 상태")
|
|
title: str = Field(..., description="영상 제목")
|
|
platform_username: Optional[str] = Field(None, description="플랫폼 채널명")
|
|
platform_url: Optional[str] = Field(None, description="플랫폼 영상 URL")
|
|
error_message: Optional[str] = Field(None, description="에러 메시지")
|
|
scheduled_at: Optional[datetime] = Field(None, description="예약 게시 시간")
|
|
created_at: datetime = Field(..., description="생성 일시")
|
|
uploaded_at: Optional[datetime] = Field(None, description="업로드 완료 일시")
|
|
|
|
model_config = ConfigDict(from_attributes=True)
|
|
|
|
|
|
class SocialUploadHistoryResponse(BaseModel):
|
|
"""업로드 이력 목록 응답"""
|
|
|
|
items: list[SocialUploadHistoryItem] = Field(..., description="업로드 이력 목록")
|
|
total: int = Field(..., description="전체 개수")
|
|
page: int = Field(..., description="현재 페이지")
|
|
size: int = Field(..., description="페이지 크기")
|
|
|
|
model_config = ConfigDict(
|
|
json_schema_extra={
|
|
"example": {
|
|
"items": [
|
|
{
|
|
"upload_id": 456,
|
|
"video_id": 123,
|
|
"platform": "youtube",
|
|
"status": "completed",
|
|
"title": "나의 첫 영상",
|
|
"platform_url": "https://www.youtube.com/watch?v=xxx",
|
|
"created_at": "2024-01-15T12:00:00",
|
|
"uploaded_at": "2024-01-15T12:05:00",
|
|
}
|
|
],
|
|
"total": 1,
|
|
"page": 1,
|
|
"size": 20,
|
|
}
|
|
}
|
|
)
|