feat(community): 스팟 소유 자가신고 + 사진 리뷰 (spot_reviews)

[cocoyoon]

목표

스팟(포스트 위 아이템 핫스팟)에 대해, 유저가 「소유 자가 신고」 후 사진(필수에 가깝게) 및 선택 텍스트로 리뷰를 남기고, 다른 유저가 스팟 단위로 리뷰 목록을 볼 수 있게 한다. (솔루션 링크 UGC와 별도 도메인.)

제품 (1차 확정)

• 소유 검증: 자가 신고만 — 체크/토글 후 작성 가능. 신고·모더이션·검수는 후속 이슈.

현재 스팟 구현

• packages/api-server/src/domains/spots/ — CRUD, GET /api/v1/spots/{spot_id} 등
• 리뷰 전용 테이블/API 없음

DB (제안)

테이블 예: spot_reviews

• id (UUID PK)
• spot_id (FK → spots, ON DELETE CASCADE 권장)
• user_id (FK → users)
• body (text, nullable) — 길이 상한 서버 검증
• image_urls (jsonb) — 1~N장, 상한(예: 5) 정책
• created_at, updated_at
• UNIQUE(spot_id, user_id) — 유저당 스팟당 1리뷰(수정은 PATCH로)

Rust (api-server)

• 새 모듈 spot_reviews(또는 spots 하위 서브라우트) — 패턴: dto → service → handlers
• GET /api/v1/spots/{spot_id}/reviews?page&per_page — 공개 목록, 작성자 프로필 필드 포함
• POST /api/v1/spots/{spot_id}/reviews — 인증; body + 이미지 URL 목록(이미 업로드된 R2 URL) 또는 멀티파트
• (선택) PATCH/DELETE 본인 리뷰만
• 이미지 업로드: 기존 posts의 R2 업로드(packages/api-server/src/domains/posts/service.rs upload_image 등) 재사용 — 클라이언트가 먼저 이미지 업로드 후 URL만 POST하는 2단계가 가장 단순할 수 있음

웹

• 포스트 상세에서 스팟/아이템이 열리는 UI(예: ImageDetailContent, 스팟 시트/모달)에 리뷰 리스트 섹션
• 로그인 유저: 「이 아이템 있어요」 확인 후 업로드 폼(이미지 + 선택 텍스트)
• Orval: openapi.json 갱신 → bun run generate:api
• docs/agent/api-v1-routes.md 표 추가

수용 기준

1. 동일 스팟에 대해 리뷰 작성 후 목록 API로 조회 가능하다.
2. 미로그인은 작성 불가, 목록은 (정책대로) 읽기 가능.
3. 마이그레이션·Entity·OpenAPI·웹이 한 PR 세트로 일관된다.

참고 파일

• packages/api-server/src/domains/spots/handlers.rs, service.rs
• packages/api-server/src/domains/posts/service.rs (스토리지 업로드)
• 포스트 상세: packages/web/lib/components/detail/ImageDetailContent.tsx

후속(별도 이슈로 쪼개기 권장)

• 신고 API, 운영 승인(draft), 솔루션 채택자만 작성 허용 등

[cocoyoon]

#24/#25로 통합합니다

논의 결과, 스팟 리뷰(소유 자가신고 + 사진)는 별도 spot_reviews 테이블 대신 Try 포스트 + 스팟 태깅으로 통합하기로 했습니다.

변경 사항

• Try 생성 시 spot_ids (optional)를 받아 try_spot_tags 조인 테이블에 저장
• GET /api/v1/spots/:spotId/tries로 스팟별 리뷰(Try) 목록 조회
• 스팟 태깅 자체가 "이 아이템 갖고 있어요" 소유 신고 역할

이유

• 유저 관점에서 "포스트 리뷰"와 "아이템 리뷰"의 구분이 모호 — 하나의 UGC 흐름으로 통합이 자연스러움
• DB 구조 단순화 (새 테이블 1개 → 조인 테이블 1개)
• 업로드 진입점 통합 (포스트 상세 → Try 업로드 한 곳)

반영된 이슈/스펙

• feat(community): Try 포스트 백엔드 — parent_post_id, tries API, OpenAPI/Orval #24 체크리스트에 try_spot_tags DB, GET /spots/:spotId/tries API 추가
• feat(community): Try 업로드 페이지 /request/try 및 CTA 라우트 정합 #25 체크리스트에 SpotTagSelector UI 추가
• specs/flows/FLW-08-my-try.md에 "feat(community): 스팟 소유 자가신고 + 사진 리뷰 (spot_reviews) #29 통합" 섹션 추가
• specs/screens/creation/SCR-CREA-TRY-01-try-upload.md에 스팟 태깅 UI 반영

본 이슈는 close합니다. 후속으로 스팟별 리뷰 집계("N명이 소유" 배지 등)가 필요하면 별도 이슈로 등록합니다.