286 lines
11 KiB
Python
286 lines
11 KiB
Python
from typing import Literal, Optional
|
|
|
|
from pydantic import BaseModel, ConfigDict, Field
|
|
|
|
|
|
class AttributeInfo(BaseModel):
|
|
"""음악 속성 정보"""
|
|
|
|
genre: str = Field(..., description="음악 장르")
|
|
vocal: str = Field(..., description="보컬 스타일")
|
|
tempo: str = Field(..., description="템포")
|
|
mood: str = Field(..., description="분위기")
|
|
|
|
|
|
class GenerateRequestImg(BaseModel):
|
|
"""이미지 URL 스키마"""
|
|
|
|
url: str = Field(..., description="이미지 URL")
|
|
name: Optional[str] = Field(None, description="이미지명 (없으면 URL에서 추출)")
|
|
|
|
|
|
class GenerateRequestInfo(BaseModel):
|
|
"""생성 요청 정보 스키마 (이미지 제외)"""
|
|
|
|
customer_name: str = Field(..., description="고객명/가게명")
|
|
region: str = Field(..., description="지역명")
|
|
detail_region_info: Optional[str] = Field(None, description="상세 지역 정보")
|
|
attribute: AttributeInfo = Field(..., description="음악 속성 정보")
|
|
language: str = Field(
|
|
default="Korean",
|
|
description="가사 출력 언어 (Korean, English, Chinese, Japanese, Thai, Vietnamese)",
|
|
)
|
|
|
|
|
|
class GenerateRequest(GenerateRequestInfo):
|
|
"""기본 생성 요청 스키마 (이미지 없음, JSON body)
|
|
|
|
이미지 없이 프로젝트 정보만 전달합니다.
|
|
"""
|
|
|
|
model_config = ConfigDict(
|
|
json_schema_extra={
|
|
"example": {
|
|
"customer_name": "스테이 머뭄",
|
|
"region": "군산",
|
|
"detail_region_info": "군산 신흥동 말랭이 마을",
|
|
"attribute": {
|
|
"genre": "K-Pop",
|
|
"vocal": "Raspy",
|
|
"tempo": "110 BPM",
|
|
"mood": "happy",
|
|
},
|
|
"language": "Korean",
|
|
}
|
|
}
|
|
)
|
|
|
|
|
|
class GenerateUrlsRequest(GenerateRequestInfo):
|
|
"""URL 기반 생성 요청 스키마 (JSON body)
|
|
|
|
GenerateRequestInfo를 상속받아 이미지 목록을 추가합니다.
|
|
"""
|
|
|
|
model_config = ConfigDict(
|
|
json_schema_extra={
|
|
"example": {
|
|
"customer_name": "스테이 머뭄",
|
|
"region": "군산",
|
|
"detail_region_info": "군산 신흥동 말랭이 마을",
|
|
"attribute": {
|
|
"genre": "K-Pop",
|
|
"vocal": "Raspy",
|
|
"tempo": "110 BPM",
|
|
"mood": "happy",
|
|
},
|
|
"language": "Korean",
|
|
"images": [
|
|
{"url": "https://example.com/images/image_001.jpg"},
|
|
{"url": "https://example.com/images/image_002.jpg", "name": "외관"},
|
|
],
|
|
}
|
|
}
|
|
)
|
|
|
|
images: list[GenerateRequestImg] = Field(
|
|
..., description="이미지 URL 목록", min_length=1
|
|
)
|
|
|
|
|
|
class GenerateUploadResponse(BaseModel):
|
|
"""파일 업로드 기반 생성 응답 스키마"""
|
|
|
|
task_id: str = Field(..., description="작업 고유 식별자 (UUID7)")
|
|
status: Literal["processing", "completed", "failed"] = Field(
|
|
..., description="작업 상태"
|
|
)
|
|
message: str = Field(..., description="응답 메시지")
|
|
uploaded_count: int = Field(..., description="업로드된 이미지 개수")
|
|
|
|
|
|
class GenerateResponse(BaseModel):
|
|
"""생성 응답 스키마"""
|
|
|
|
task_id: str = Field(..., description="작업 고유 식별자 (UUID7)")
|
|
status: Literal["processing", "completed", "failed"] = Field(
|
|
..., description="작업 상태"
|
|
)
|
|
message: str = Field(..., description="응답 메시지")
|
|
|
|
|
|
class CrawlingRequest(BaseModel):
|
|
"""크롤링 요청 스키마"""
|
|
|
|
model_config = ConfigDict(
|
|
json_schema_extra={
|
|
"example": {
|
|
"url": "https://map.naver.com/p/search/%EC%8A%A4%ED%85%8C%EC%9D%B4%EB%A8%B8%EB%AD%84/place/1133638931?c=14.70,0,0,0,dh&placePath=/photo?businessCategory=pension&fromPanelNum=2&locale=ko&searchText=%EC%8A%A4%ED%85%8C%EC%9D%B4%EB%A8%B8%EB%AD%84&svcName=map_pcv5×tamp=202512191123&fromPanelNum=2&locale=ko&searchText=%EC%8A%A4%ED%85%8C%EC%9D%B4%EB%A8%B8%EB%AD%84&svcName=map_pcv5×tamp=202512191007&from=map&entry=bmp&filterType=%EC%97%85%EC%B2%B4&businessCategory=pension"
|
|
}
|
|
}
|
|
)
|
|
|
|
url: str = Field(..., description="네이버 지도 장소 URL")
|
|
|
|
class AutoCompleteRequest(BaseModel):
|
|
"""자동완성 요청 스키마"""
|
|
|
|
model_config = ConfigDict(
|
|
json_schema_extra={
|
|
"example": {
|
|
'title': '<b>스테이</b>,<b>머뭄</b>',
|
|
'address': '전북특별자치도 군산시 신흥동 63-18',
|
|
'roadAddress': '전북특별자치도 군산시 절골길 18',
|
|
}
|
|
}
|
|
)
|
|
|
|
title: str = Field(..., description="네이버 검색 place API Title")
|
|
address: str = Field(..., description="네이버 검색 place API 지번주소")
|
|
roadAddress: Optional[str] = Field(None, description="네이버 검색 place API 도로명주소")
|
|
|
|
class ProcessedInfo(BaseModel):
|
|
"""가공된 장소 정보 스키마"""
|
|
|
|
customer_name: str = Field(..., description="고객명/가게명 (base_info.name)")
|
|
region: str = Field(..., description="지역명 (roadAddress에서 추출한 시 이름)")
|
|
detail_region_info: str = Field(..., description="상세 지역 정보 (roadAddress)")
|
|
|
|
|
|
class MarketingAnalysisDetail(BaseModel):
|
|
detail_title : str = Field(..., description="디테일 카테고리 이름")
|
|
detail_description : str = Field(..., description="해당 항목 설명")
|
|
|
|
class MarketingAnalysisReport(BaseModel):
|
|
"""마케팅 분석 리포트 스키마"""
|
|
summary : str = Field(..., description="비즈니스 한 줄 요약")
|
|
details : list[MarketingAnalysisDetail] = Field(default_factory=list, description="개별 디테일")
|
|
|
|
class MarketingAnalysis(BaseModel):
|
|
"""마케팅 분석 결과 스키마"""
|
|
|
|
report: MarketingAnalysisReport = Field(..., description="마케팅 분석 리포트")
|
|
tags: list[str] = Field(default_factory=list, description="추천 태그 목록")
|
|
selling_points: list[str] = Field(default_factory=list, description="추천 부대시설 목록")
|
|
|
|
|
|
class CrawlingResponse(BaseModel):
|
|
"""크롤링 응답 스키마"""
|
|
|
|
image_list: Optional[list[str]] = Field(None, description="이미지 URL 목록")
|
|
image_count: int = Field(..., description="이미지 개수")
|
|
processed_info: Optional[ProcessedInfo] = Field(
|
|
None, description="가공된 장소 정보 (customer_name, region, detail_region_info)"
|
|
)
|
|
marketing_analysis: Optional[MarketingAnalysis] = Field(
|
|
None, description="마케팅 분석 결과 (report, tags, facilities)"
|
|
)
|
|
|
|
|
|
class ErrorResponse(BaseModel):
|
|
"""에러 응답 스키마"""
|
|
|
|
success: bool = Field(default=False, description="요청 성공 여부")
|
|
error_code: str = Field(..., description="에러 코드")
|
|
message: str = Field(..., description="에러 메시지")
|
|
detail: Optional[str] = Field(None, description="상세 에러 정보")
|
|
|
|
|
|
# =============================================================================
|
|
# Image Upload Schemas
|
|
# =============================================================================
|
|
|
|
|
|
class ImageUrlItem(BaseModel):
|
|
"""이미지 URL 아이템 스키마"""
|
|
|
|
url: str = Field(..., description="외부 이미지 URL")
|
|
name: Optional[str] = Field(None, description="이미지명 (없으면 URL에서 추출)")
|
|
|
|
|
|
class ImageUploadRequest(BaseModel):
|
|
"""이미지 업로드 요청 스키마 (JSON body 부분)
|
|
|
|
URL 이미지 목록을 전달합니다.
|
|
바이너리 파일은 multipart/form-data로 별도 전달됩니다.
|
|
"""
|
|
|
|
model_config = ConfigDict(
|
|
json_schema_extra={
|
|
"example": {
|
|
"images": [
|
|
{"url": "https://example.com/images/image_001.jpg"},
|
|
{"url": "https://example.com/images/image_002.jpg", "name": "외관"},
|
|
]
|
|
}
|
|
}
|
|
)
|
|
|
|
images: Optional[list[ImageUrlItem]] = Field(
|
|
None, description="외부 이미지 URL 목록"
|
|
)
|
|
|
|
|
|
class ImageUploadResultItem(BaseModel):
|
|
"""업로드된 이미지 결과 아이템"""
|
|
|
|
id: int = Field(..., description="이미지 ID")
|
|
img_name: str = Field(..., description="이미지명")
|
|
img_url: str = Field(..., description="이미지 URL")
|
|
img_order: int = Field(..., description="이미지 순서")
|
|
source: Literal["url", "file", "blob"] = Field(
|
|
..., description="이미지 소스 (url: 외부 URL, file: 로컬 서버, blob: Azure Blob)"
|
|
)
|
|
|
|
|
|
class ImageUploadResponse(BaseModel):
|
|
"""이미지 업로드 응답 스키마"""
|
|
|
|
model_config = ConfigDict(
|
|
json_schema_extra={
|
|
"example": {
|
|
"task_id": "0694b716-dbff-7219-8000-d08cb5fce431",
|
|
"total_count": 3,
|
|
"url_count": 2,
|
|
"file_count": 1,
|
|
"saved_count": 3,
|
|
"images": [
|
|
{
|
|
"id": 1,
|
|
"img_name": "외관",
|
|
"img_url": "https://example.com/images/image_001.jpg",
|
|
"img_order": 0,
|
|
"source": "url",
|
|
},
|
|
{
|
|
"id": 2,
|
|
"img_name": "내부",
|
|
"img_url": "https://example.com/images/image_002.jpg",
|
|
"img_order": 1,
|
|
"source": "url",
|
|
},
|
|
{
|
|
"id": 3,
|
|
"img_name": "uploaded_image.jpg",
|
|
"img_url": "/media/image/2024-01-15/0694b716-dbff-7219-8000-d08cb5fce431/uploaded_image_002.jpg",
|
|
"img_order": 2,
|
|
"source": "file",
|
|
},
|
|
],
|
|
"image_urls": [
|
|
"https://example.com/images/image_001.jpg",
|
|
"https://example.com/images/image_002.jpg",
|
|
"/media/image/2024-01-15/0694b716-dbff-7219-8000-d08cb5fce431/uploaded_image_002.jpg",
|
|
],
|
|
}
|
|
}
|
|
)
|
|
|
|
task_id: str = Field(..., description="작업 고유 식별자 (새로 생성된 UUID7)")
|
|
total_count: int = Field(..., description="총 업로드된 이미지 개수")
|
|
url_count: int = Field(..., description="URL로 등록된 이미지 개수")
|
|
file_count: int = Field(..., description="파일로 업로드된 이미지 개수")
|
|
saved_count: int = Field(..., description="Image 테이블에 저장된 row 수")
|
|
images: list[ImageUploadResultItem] = Field(..., description="업로드된 이미지 목록")
|
|
image_urls: list[str] = Field(..., description="Image 테이블에 저장된 현재 task_id의 이미지 URL 목록")
|