o2o-site-AEO/solution/backend/router/v1/site/review.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

70 lines
2.4 KiB
Python

"""이용 후기 접수 — 발행본에서 손님이 남긴다."""
import uuid
from fastapi import APIRouter, Depends, Query, Request
from pydantic import BaseModel, Field
from common.logger import LOG
from router.v1.site.booking_request import MIN_ELAPSED_MS, _allow
from router.v1.validator.dependencies import RemoveNoneResponse
from services.review_service import ReviewService
router = APIRouter(prefix="/v1/site", tags=["Site"])
IP_LIMIT_PER_HOUR = 3
PLACE_LIMIT_PER_HOUR = 30
class ReqReview(BaseModel):
place_id: uuid.UUID
body: str = Field(min_length=1, max_length=1000)
nickname: str | None = Field(default=None, max_length=40)
consent: bool
company: str | None = Field(default=None, max_length=100)
elapsed_ms: int = 0
client_ip: str | None = None
class ResReview(BaseModel):
success: bool
message: str
class PublicReview(BaseModel):
reviewId: str
body: str
nickname: str
publishedAt: str
class ResPublicReviews(BaseModel):
items: list[PublicReview] = []
@router.post(path="/review", response_model=ResReview, summary="이용 후기 남기기")
async def submit_review(body: ReqReview, request: Request, service: ReviewService = Depends()):
client_ip = (request.headers.get("x-forwarded-for", "").split(",")[0].strip()
or (request.client.host if request.client else "unknown"))
if body.company or body.elapsed_ms < MIN_ELAPSED_MS:
LOG.w("[review] 봇 의심 요청을 버렸다")
return RemoveNoneResponse(ResReview(success=True, message="후기를 남겨 주셔서 고맙습니다."))
if not body.consent:
return RemoveNoneResponse(ResReview(success=False, message="공개에 동의해 주세요."))
if not _allow(f"review-ip:{client_ip}", IP_LIMIT_PER_HOUR) or \
not _allow(f"review-place:{body.place_id}", PLACE_LIMIT_PER_HOUR):
return RemoveNoneResponse(ResReview(
success=False, message="요청이 많습니다. 잠시 뒤 다시 남겨 주세요.",
))
body.client_ip = client_ip
return RemoveNoneResponse(await service.submit(body))
@router.get(path="/reviews", response_model=ResPublicReviews, summary="게재된 후기 — 발행본이 붙은 뒤 받아 간다")
async def list_reviews(place_id: uuid.UUID = Query(), service: ReviewService = Depends()):
"""날씨(/v1/local/weather)와 같은 공개 조회다."""
return RemoveNoneResponse(await service.list_public(place_id))