From b3354d4ad1815b6d0883b084b8dd4971f05790bd Mon Sep 17 00:00:00 2001 From: jaehwang Date: Fri, 20 Feb 2026 01:11:57 +0000 Subject: [PATCH] =?UTF-8?q?=EC=9C=A0=ED=8A=9C=EB=B8=8C=20SEO=20=EC=84=A4?= =?UTF-8?q?=EB=AA=85=20=EC=B6=94=EA=B0=80=20PoC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- app/lyric/api/routers/v1/lyric.py | 1 - app/social/api/routers/v1/upload.py | 71 +++++++++++++++++-- app/social/schemas.py | 26 +++++++ app/utils/chatgpt_prompt.py | 2 +- app/utils/prompts/prompts.py | 10 ++- app/utils/prompts/schemas/__init__.py | 3 +- .../schemas/{youtube_desc.py => youtube.py} | 0 config.py | 2 + 8 files changed, 106 insertions(+), 9 deletions(-) rename app/utils/prompts/schemas/{youtube_desc.py => youtube.py} (100%) diff --git a/app/lyric/api/routers/v1/lyric.py b/app/lyric/api/routers/v1/lyric.py index c508723..50f6575 100644 --- a/app/lyric/api/routers/v1/lyric.py +++ b/app/lyric/api/routers/v1/lyric.py @@ -292,7 +292,6 @@ async def generate_lyric( "promotional_expression_example" : promotional_expressions[request_body.language], "timing_rules" : timing_rules["60s"], # 아직은 선택지 하나 } - estimated_prompt = lyric_prompt.build_prompt(lyric_input_data) step1_elapsed = (time.perf_counter() - step1_start) * 1000 #logger.debug(f"[generate_lyric] Step 1 완료 - 프롬프트 {len(prompt)}자 ({step1_elapsed:.1f}ms)") diff --git a/app/social/api/routers/v1/upload.py b/app/social/api/routers/v1/upload.py index f9a3889..9e5c1ea 100644 --- a/app/social/api/routers/v1/upload.py +++ b/app/social/api/routers/v1/upload.py @@ -4,10 +4,11 @@ 소셜 미디어 영상 업로드 관련 엔드포인트를 제공합니다. """ -import logging +import logging, json from typing import Optional from fastapi import APIRouter, BackgroundTasks, Depends, Query +from fastapi import HTTPException, status from sqlalchemy import select, func from sqlalchemy.ext.asyncio import AsyncSession @@ -22,12 +23,17 @@ from app.social.schemas import ( SocialUploadRequest, SocialUploadResponse, SocialUploadStatusResponse, + YoutubeDescriptionRequest, + YoutubeDescriptionResponse, ) from app.social.services import social_account_service from app.social.worker.upload_task import process_social_upload from app.user.dependencies import get_current_user from app.user.models import User +from app.home.models import Project, MarketingIntel from app.video.models import Video +from app.utils.prompts.prompts import yt_upload_prompt +from app.utils.chatgpt_prompt import ChatgptService, ChatGPTResponseError logger = logging.getLogger(__name__) @@ -403,16 +409,12 @@ async def cancel_upload( upload = result.scalar_one_or_none() if not upload: - from fastapi import HTTPException, status - raise HTTPException( status_code=status.HTTP_404_NOT_FOUND, detail="업로드 정보를 찾을 수 없습니다.", ) if upload.status != UploadStatus.PENDING.value: - from fastapi import HTTPException, status - raise HTTPException( status_code=status.HTTP_400_BAD_REQUEST, detail="대기 중인 업로드만 취소할 수 있습니다.", @@ -425,3 +427,62 @@ async def cancel_upload( success=True, message="업로드가 취소되었습니다.", ) + + +@router.post( + "/autodescription", + response_model=YoutubeDescriptionResponse, + summary="유튜브 SEO descrption 생성", + description="유튜브 업로드 시 사용할 descrption을 SEO 적용하여 생성", +) +async def youtube_seo_description( + request_body: YoutubeDescriptionRequest, + current_user: User = Depends(get_current_user), + session: AsyncSession = Depends(get_session), + ) -> YoutubeDescriptionResponse: + + logger.info( + f"[youtube_seo_description] START - user: {current_user.user_uuid} " + ) + try: + task_id = request_body.task_id + project_query = await session.execute( + select(Project) + .where( + Project.task_id == task_id, + Project.user_uuid == current_user.user_uuid) + .order_by(Project.created_at.desc()) + .limit(1) + ) + + project = project_query.scalar_one_or_none() + marketing_query = await session.execute( + select(MarketingIntel) + .where(MarketingIntel.id == project.marketing_inteligence) + ) + marketing_intelligence = marketing_query.scalar_one_or_none() + + hashtags = marketing_intelligence.intel_result["target_keywords"] + + yt_seo_input_data = { + "customer_name" : project.store_name, + "detail_region_info" : project.detail_region_info, + "marketing_intelligence_summary" : json.dumps(marketing_intelligence.intel_result, ensure_ascii=False), + "language" : project.language, + "target_keywords" : hashtags + } + chatgpt = ChatgptService() + yt_seo_output = await chatgpt.generate_structured_output(yt_upload_prompt, yt_seo_input_data) + response = YoutubeDescriptionResponse( + title=yt_seo_output.title, + description=yt_seo_output.description, + keywords = hashtags + ) + return response + + except Exception as e: + logger.error(f"[youtube_seo_description] EXCEPTION - error: {e}") + raise HTTPException( + status_code=500, + detail=f"유튜브 SEO 생성에 실패했습니다. : {str(e)}", + ) diff --git a/app/social/schemas.py b/app/social/schemas.py index 2a3a1f6..580a1cb 100644 --- a/app/social/schemas.py +++ b/app/social/schemas.py @@ -276,6 +276,32 @@ class SocialUploadHistoryResponse(BaseModel): } ) +class YoutubeDescriptionRequest(BaseModel): + """유튜브 SEO Description 제안 (자동완성) Request 모델""" + + model_config = ConfigDict( + json_schema_extra={ + "example": { + "task_id" : "019c739f-65fc-7d15-8c88-b31be00e588e" + } + } + ) + task_id: str = Field(..., description="작업 고유 식별자") + +class YoutubeDescriptionResponse(BaseModel): + """유튜브 SEO Description 제안 (자동완성) Response 모델""" + title:str = Field(..., description="유튜브 영상 제목 - SEO/AEO 최적화") + description : str = Field(..., description="제안된 유튜브 SEO Description") + keywords : list[str] = Field(..., description="해시태그 리스트") + model_config = ConfigDict( + json_schema_extra={ + "example": { + "title" : "여기에 더미 타이틀", + "description": "여기에 더미 텍스트", + "keywords": ["여기에", "더미", "해시태그"] + } + } + ) # ============================================================================= # 공통 응답 스키마 diff --git a/app/utils/chatgpt_prompt.py b/app/utils/chatgpt_prompt.py index 0f1ede4..4b9a950 100644 --- a/app/utils/chatgpt_prompt.py +++ b/app/utils/chatgpt_prompt.py @@ -82,7 +82,7 @@ class ChatgptService: self, prompt : Prompt, input_data : dict, - ) -> str: + ) -> BaseModel: prompt_text = prompt.build_prompt(input_data) logger.debug(f"[ChatgptService] Generated Prompt (length: {len(prompt_text)})") diff --git a/app/utils/prompts/prompts.py b/app/utils/prompts/prompts.py index d9f5020..336318b 100644 --- a/app/utils/prompts/prompts.py +++ b/app/utils/prompts/prompts.py @@ -52,6 +52,14 @@ lyric_prompt = Prompt( prompt_model = prompt_settings.LYRIC_PROMPT_MODEL ) +yt_upload_prompt = Prompt( + prompt_template_path=os.path.join(prompt_settings.PROMPT_FOLDER_ROOT, prompt_settings.YOUTUBE_PROMPT_FILE_NAME), + prompt_input_class = YTUploadPromptInput, + prompt_output_class = YTUploadPromptOutput, + prompt_model = prompt_settings.YOUTUBE_PROMPT_MODEL +) + def reload_all_prompt(): marketing_prompt._reload_prompt() - lyric_prompt._reload_prompt() \ No newline at end of file + lyric_prompt._reload_prompt() + yt_upload_prompt._reload_prompt() \ No newline at end of file diff --git a/app/utils/prompts/schemas/__init__.py b/app/utils/prompts/schemas/__init__.py index 4080837..8cd267f 100644 --- a/app/utils/prompts/schemas/__init__.py +++ b/app/utils/prompts/schemas/__init__.py @@ -1,2 +1,3 @@ from .lyric import LyricPromptInput, LyricPromptOutput -from .marketing import MarketingPromptInput, MarketingPromptOutput \ No newline at end of file +from .marketing import MarketingPromptInput, MarketingPromptOutput +from .youtube import YTUploadPromptInput, YTUploadPromptOutput \ No newline at end of file diff --git a/app/utils/prompts/schemas/youtube_desc.py b/app/utils/prompts/schemas/youtube.py similarity index 100% rename from app/utils/prompts/schemas/youtube_desc.py rename to app/utils/prompts/schemas/youtube.py diff --git a/config.py b/config.py index 94c7c7c..3087ce9 100644 --- a/config.py +++ b/config.py @@ -184,6 +184,8 @@ class PromptSettings(BaseSettings): LYRIC_PROMPT_FILE_NAME : str = Field(default="lyric_prompt.txt") LYRIC_PROMPT_MODEL : str = Field(default="gpt-5-mini") + YOUTUBE_PROMPT_FILE_NAME : str = Field(default="yt_upload_prompt.txt") + YOUTUBE_PROMPT_MODEL : str = Field(default="gpt-5-mini") model_config = _base_config