OOTD 피드 기능 설계

1. 기능 개요

• OOTD(Outfit of the Day) 피드 기능은 사용자가 착장을 업로드하고, 다른 사용자가 이를 조회·검색·피드백(좋아요, 댓글)할 수 있도록 지원하는 기능입니다.
• 검색 및 조회는 Elasticsearch를 기반으로 구현되어 빠른 텍스트 검색과 필터링을 지원합니다.

2. API 목록

3. 기능별 상세 설계

📌 피드 등록

• 작업 요약
  • FeedCreateRequest DTO
    • content: @NotBlank
    • clothesIds: List<UUID> (연관된 의상)
    • weatherId: UUID (날씨 정보)
  • 응답 DTO: FeedDto (id, author, content, createdAt, clothes, weather)
  • Controller → Service → Repository → Entity 저장
  • 저장 직후 FeedCreatedEvent 발행 → 비동기 리스너에서 Elasticsearch 인덱싱 처리
• 예외 처리
  • 400 Bad Request: 입력값 오류
  • 404 Not Found: 잘못된 사용자/날씨/옷 ID 참조
  • 500 Internal Server Error: 서버 내부 오류

📌 피드 목록 조회

• 작업 요약

  • API: GET /api/feeds

  • 최신순(createdAt DESC/ASC), 인기순(likeCount DESC/ASC) 조회 지원

  • Pagination: Cursor 기반 페이징 (createdAt + id)

  • 응답 DTO: FeedSummaryDto (id, author, previewContent, likeCount, commentCount, createdAt)

  • Elasticsearch 활용

    • 단순 목록 조회 시 RDBMS (고려), 필터링 및 검색 시 ElasticSearch 사용
    • 특정 조건 기반(예: 특정 옷 속성 포함, 날씨 조건, 내용 포함 검색)의 목록 조회를Elasticsearch로 빠르게 검색 및 필터링
    • content 기반으로 역인덱스 생성 (ngram tokenizer 사용)
      • 검색어는 nori tokenizer 사용
    • 인덱스 필드 예시:

    {
      "feedId": "7c8a9f12-34de-5678-9012-abcd3456ef78",
      "createdAt": "2025-09-01T09:00:00Z",
      "updatedAt": "2025-09-01T10:00:00Z",
      "author": {
        "userId": "1111-2222-3333-4444",
        "name": "woody",
        "profileImageUrl": "<https://cdn.monew.com/profile/woody.png>"
      },
      "likeCount": 15,
      "weather": {
        "weatherId": "wx-20250901",
        "skyStatus": "CLOUDY",
        "precipitation": {
          "type": "RAIN",
          "amount": 3.5,
          "probability": 70.0
        },
        "temperature": {
          "current": 24.5,
          "comparedToDayBefore": -1.2,
          "min": 20.0,
          "max": 27.0
        }
      },
      "ootds": [
        {
          "clothesId": "c-1001",
          "name": "청자켓",
          "imageKey": "ootd/2025/09/01/jacket.png",
          "contentType": "image/png",
          "type": "OUTER",
          "attributes": {
            "definitionId": "def-11",
            "definitionName": "계절",
            "selectableValues": ["봄", "가을"],
            "value": "가을"
          }
        },
        {
          "clothesId": "c-1002",
          "name": "흰색 티셔츠",
          "imageKey": "ootd/2025/09/01/tshirt.png",
          "contentType": "image/png",
          "type": "TOP",
          "attributes": {
            "definitionId": "def-12",
            "definitionName": "스타일",
            "selectableValues": ["캐주얼", "포멀"],
            "value": "캐주얼"
          }
        }
      ],
      "content": "오늘은 청자켓과 흰색 티셔츠로 캐주얼한 스타일을 입었어요."
    }
    

• 예외 처리

  • 404 Not Found: 잘못된 feed ID 참조
  • 500 Internal Server Error: 조회 실패

📌 피드 좋아요 / 좋아요 취소

• 작업 요약
  • API:
    • POST /api/feeds/{feedId}/like → 좋아요 등록
    • DELETE /api/feeds/{feedId}/like → 좋아요 취소
  • Service: FeedLikeService.addLike(), FeedLikeService.removeLike()
  • DB 저장 후, 피드 likeCount 업데이트
  • 원자적 연산 + 복합 Unique 제약조건을 통한 동시성 제어
• 예외 처리
  • 403 Forbidden: 본인이 아닌 경우
  • 404 Not Found: 없는 피드
  • 409 Conflict: 이미 좋아요 상태