from typing import Optional from uuid import UUID from fastapi import APIRouter, Depends, Query from common.models.gmodel import UserInfo from router.v1.validator.dependencies import IsValidAccessToken, RemoveNoneResponse from services.media_service import MediaService from .protocol import Res_MediaList # 사진 라우터. 사업장(place_id) 하위 리소스이며, 회사 스코프는 service 가 사업장 조회로 강제한다. router = APIRouter(prefix="/v1/place/{place_id}/media", tags=["Media"], responses={404: {"description": "Not found"}}) @router.get( path="/list", response_model=Res_MediaList, summary="사진 목록", description="publishable_only=true 면 ★ 사이트에 실제로 나갈 수 있는 것(승인 + alt 있음)만 — " "빌드 스냅샷과 같은 기준이다. unit_id 를 주면 그 객실·메뉴 사진만. " "★ 응답에는 항상 source_type(owner/crawl)과 origin_url 이 실린다 — " "크롤링 이미지 재게시 권리가 미결이라(docs/DECISIONS.md 1-2) 결론에 따라 " "CRAWL 을 통째로 걸러내야 하고, 화면이 출처를 모르면 그 판단을 못 한다.", ) async def list_media( place_id: UUID, service: MediaService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken), unit_id: Optional[UUID] = Query(None, description="객실·메뉴 단위 사진만"), publishable_only: bool = Query(False), ): return RemoveNoneResponse(await service.list_media(user_info, str(place_id), unit_id, publishable_only))