o2o-site-AEO/solution/backend/router/v1/media/media.py
Mina Choi 11d30bb3d1 [chore] solution,admin,ontology: 코드 주석을 한 줄로 — 히스토리 주석 삭제
여러 줄 주석이 설명보다 경위(예전·실측·지적)를 적고 있어 읽는 사람이 결론을 찾기 어려웠다.

- ts·tsx·js·mjs·css·py 478개: 여러 줄 주석은 첫 문장 한 줄로, 과거형·날짜 문장은 삭제
- 주석 위치는 TypeScript 파서·파이썬 tokenize/ast 로 찾는다 — 문자열 안의 # · /* 는 건드리지 않는다
- eslint·ts·noqa·type: ignore 같은 지시 주석은 그대로 둔다

파이썬 275개 정리 전후 AST 동일, TS 298개 주석 뺀 토큰 동일(빈 JSX 주석 10곳만 차이).
site·frontend·admin tsc, site vitest 105 passed

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-28 16:05:19 +09:00

33 lines
1.5 KiB
Python

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
# 사진 라우터.
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))