1. 기능 개요

• 의상 관리 기능은 사용자가 자신의 옷을 등록, 수정, 삭제, 조회할 수 있는 기능입니다.
• 의상 속성 정의 기능은 관리자가 의상 속성을 정의하여 의상 속성 및 속성값을 관리하고 사용자가 의상을 등록할 때 선택할 수 있도록 지원합니다.
• 사용자는 구매 링크(URL)을 입력하면 LLM기반의 의상 정보 추출 기능을 통해 초기값을 자동으로 채워 사용자 편의성을 제공합니다.
• 주요 기능은 의상 등록, 수정, 삭제, 목록 조회, 링크 기반 정보 추출, 속성정의 등록, 수정,삭제, 조회이며 각 기능에는 유효성 검사 및 예외 처리가 포함됩니다.
• 모든 요청은 로그인한 사용자에 의해 수행됩니다.

2. API 목록

3. 기능별 상세 설계

📌 의상 등록

• 작업 요약:
  • ClothesCreateRequest DTO 설계(record 기반)
    • ownerId(의상 소유자 ID) : @NotNull
    • name(이름): @NotBlank
    • type(의상 타입): @Enum(ClothesType) , @NotNull
    • attributes(속성): List<ClothesAttributeDto> (definitionId + value)
  • MultipartFile imageFile (선택적 @RequestPart(”image”))
  • ClothesDto 응답 DTO 설계(record 기반)
    • id, ownerId, name, imageUrl, type, attributes ,createdAt
  • 속성 매핑: ClothesSelectedValue 엔티티와 연결
  • 의상 등록 API 구현(POST /api/clothes)
    • Controller → Service → Repository → Entity 저장
    • 소유자 확인: userRepository.findById()
    • 속성 검증: 중복 속성 정의 확인, 정의/값 존재 여부 확인
    • 이미지 업로드: ClothesImageService + S3ImageStorage
    • 등록 이벤트 발행: ClothesCreatedEvent
    • Mapper(ClothesMapper)로 DTO 변환
  • 성공시 201 Created + ClothesDto 응답
  • 예외 처리:

    • 400 Bad Request :

      • DTO 유효성 실패 → MethodArgumentNotValidException
      • 속성 정의 중복 → ATTRIBUTE_DEFINITION_DUPLICATE

    • 401 Unauthorized : 로그인하지 않은 사용자

    • 403 Forbidden :

                                `@PreAuthorize("#request.ownerId() == principal.user.id")` 불일치
      

    • 404 Not Found

      • 소유자 없음 → USER_NOT_FOUND
      • 속성 정의 없음 → ATTRIBUTE_DEFINITION_NOT_FOUND
      • 속성 값 없음 → ATTRIBUTE_VALUE_NOT_FOUND

    • 415 Unsupported Media Type : 이미지 포맷 오류

    • 500 Internal Server Error: 서버 오류 → 전역 처리

📌 의상 수정

• 작업 요약:
  • ClothesUpdateRequest DTO 설계(record 기반)
    • name(이름)
    • type(의상 타입): @Enum(ClothesType)
    • attributes(의상 속성): List<ClothesAttributeDto> (선택)
  • MultipartFile imageFile (선택적)
  • API 구현(PATCH /api/clothes/{clothesId})
    • Controller → Service → Repository → Entity 수정
    • 소유자 확인: 요청자 ID와 ownerId 비교
    • 속성 검증: 기존 값과 변경 요청 비교 후 업데이트
    • 이미지 교체: 새 파일 업로드 후 Presigned URL 반환
    • 수정 이벤트 발행: ClothesUpdatedEvent
  • 성공 시 200 OK + ClothesDto 응답
  • 예외 처리:
    • 400 Bad Request: DTO 유효성 실패, 속성 정의 중복
    • 401 Unauthorized: 로그인하지 않은 사용자
    • 403 Forbidden: 소유자 불일치
    • 404 Not Found: 의상 없음, 속성 정의/값 없음
    • 415 Unsupported Media Type: 이미지 포맷 오류
    • 500 Internal Server Error: 서버 오류

📌 의상 삭제

• 작업 요약:
  • API 구현(DELETE /api/clothes/{clothesId})
    • Controller → Service → Repository
    • 소유자 확인 후 삭제 가능
    • 이미지가 있으면 clothesImageService.delete() 호출
    • 삭제 이벤트 발행: ClothesDeletedEvent
  • 성공 시 204 No Content 응답
  • 예외 처리:
    • 401 Unauthorized: 로그인하지 않은 사용자
    • 403 Forbidden: 소유자 불일치
    • 404 Not Found: 의상 없음
    • 500 Internal Server Error: 서버 오류

📌 의상 목록 조회

• 작업 요약:
  • ClothesSearchCondition DTO 설계
    • cursor: String
    • idAfter: UUID
    • limit: int (@Min(1))
    • typeEqual: ClothesType
    • ownerId: UUID
  • API 구현(GET /api/clothes)
  • ClothesDtoCursorResponse 응답
  • 성공 시 200 OK + Cursor 응답
  • 예외 처리: