feat: 플레이리스트 구현

.gitignore

@@ -78,4 +78,9 @@ $RECYCLE.BIN/
 
 ### 로컬 업로드 파일 디렉토리 ###
 uploads/
-uploads-test/
+uploads-test/
+
+### .vscode ###
+bin/
+.vscode/
+.settings/

build.gradle

@@ -32,8 +32,8 @@ dependencies {
     implementation 'org.flywaydb:flyway-database-postgresql'
     implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.17'
     implementation 'org.mapstruct:mapstruct:1.6.3'
-    implementation 'com.querydsl:querydsl-jpa:5.1.0:jakarta'
-    annotationProcessor 'com.querydsl:querydsl-apt:5.1.0:jakarta'
+    implementation 'io.github.openfeign.querydsl:querydsl-jpa:7.1'
+    annotationProcessor 'io.github.openfeign.querydsl:querydsl-apt:7.1:jpa'
     annotationProcessor 'jakarta.annotation:jakarta.annotation-api'
     annotationProcessor 'jakarta.persistence:jakarta.persistence-api'
     // AWS SDK (S3)
@@ -71,6 +71,8 @@ dependencies {
     testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
     testAnnotationProcessor 'org.projectlombok:lombok'
     runtimeOnly 'io.micrometer:micrometer-registry-prometheus'
+    // .env
+    implementation 'me.paulschwarz:spring-dotenv:5.1.0'
 }
 
 tasks.named('test') {
@@ -82,12 +84,61 @@ jacoco {
     toolVersion = '0.8.12'
 }
 
+def jacocoExcludePatterns = [
+        "**/*Application*",
+        "**/config/**",
+        "**/dto/**",
+        "**/entity/**",
+        "**/exception/**",
+        "**/event/**",
+        "**/mapper/**",
+        "**/constant/**",
+        "**/controller/api/**",
+        "**/Q*.class",
+        "**/*MapperImpl.class",
+        "**/*properties.class",
+        "**/*Decorator.class",
+        "**/MdcLoggingFilter.class",
+        "**/AuthUser.class",
+]
+
+tasks.withType(JacocoReportBase) {
+    afterEvaluate {
+        classDirectories.setFrom(files(classDirectories.files.collect {
+            fileTree(dir: it, exclude: jacocoExcludePatterns)
+        }))
+    }
+}
+
+def openJacocoReport = false // true 로 설정 시 테스트 완료 후 리포트 자동 열림
+
 jacocoTestReport {
     dependsOn test
     reports {
         xml.required = true
         html.required = true
     }
+    afterEvaluate {
+        classDirectories.setFrom(files(classDirectories.files.collect {
+            fileTree(dir: it, exclude: jacocoExcludePatterns)
+        }))
+    }
+    doLast {
+        if (openJacocoReport) {
+            def reportFile = reports.html.entryPoint
+            if (reportFile.exists()) {
+                println "Opening JaCoCo Report: ${reportFile}"
+                def os = org.gradle.internal.os.OperatingSystem.current()
+                if (os.isWindows()) {
+                    exec { commandLine 'cmd', '/c', "start \"\" \"${reportFile}\"" }
+                } else if (os.isMacOsX()) {
+                    exec { commandLine 'open', reportFile }
+                } else {
+                    exec { commandLine 'xdg-open', reportFile }
+                }
+            }
+        }
+    }
 }
 
 jacocoTestCoverageVerification {

src/main/java/com/codeit/team5/mopl/global/dto/CursorResponse.java

@@ -10,5 +10,19 @@ public record CursorResponse<T>(List<T> data,
                                 boolean hasNext,
                                 long totalCount,
                                 String sortBy,
-                                String sortDirection) {
+    String sortDirection) {
+
+    @Override
+    public String sortDirection() {
+        if (sortDirection == null) {
+            return null;
+        }
+        if (sortDirection.equalsIgnoreCase("ASC") || sortDirection.equalsIgnoreCase("ASCENDING")) {
+            return "ASCENDING";
+        }
+        if (sortDirection.equalsIgnoreCase("DESC") || sortDirection.equalsIgnoreCase("DESCENDING")) {
+            return "DESCENDING";
+        }
+        return sortDirection;
+    }
 }

src/main/java/com/codeit/team5/mopl/global/mapper/GlobalMapperConfig.java

@@ -0,0 +1,15 @@
+package com.codeit.team5.mopl.global.mapper;
+
+import org.mapstruct.InjectionStrategy;
+import org.mapstruct.MapperConfig;
+import org.mapstruct.MappingConstants;
+import org.mapstruct.NullValuePropertyMappingStrategy;
+import org.mapstruct.ReportingPolicy;
+
+@MapperConfig(componentModel = MappingConstants.ComponentModel.SPRING,
+        unmappedTargetPolicy = ReportingPolicy.WARN,
+        nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE,
+        injectionStrategy = InjectionStrategy.CONSTRUCTOR)
+public interface GlobalMapperConfig {
+
+}

src/main/java/com/codeit/team5/mopl/notification/eventlistener/NotificationEventListener.java

@@ -5,11 +5,11 @@
 import com.codeit.team5.mopl.notification.entity.NotificationType;
 import com.codeit.team5.mopl.notification.event.DirectMessageSentEvent;
 import com.codeit.team5.mopl.watcher.event.WatchingSessionCreatedEvent;
-import com.codeit.team5.mopl.playlist.entity.event.PlaylistSubscribedEvent;
-import com.codeit.team5.mopl.playlist.entity.event.PlaylistUpdatedEvent;
 import com.codeit.team5.mopl.user.event.RoleChangedEvent;
 import com.codeit.team5.mopl.follow.event.UserFollowedEvent;
 import com.codeit.team5.mopl.notification.service.NotificationService;
+import com.codeit.team5.mopl.playlist.event.PlaylistSubscribedEvent;
+import com.codeit.team5.mopl.playlist.event.PlaylistUpdatedEvent;
 import java.util.List;
 import java.util.UUID;
 import lombok.RequiredArgsConstructor;

src/main/java/com/codeit/team5/mopl/playlist/constant/PlaylistSortBy.java

@@ -0,0 +1,36 @@
+package com.codeit.team5.mopl.playlist.constant;
+
+import com.codeit.team5.mopl.playlist.exception.PlaylistIncorrectSortByException;
+import com.codeit.team5.mopl.playlist.exception.PlaylistSortByMismatchException;
+import java.time.Instant;
+import java.util.function.Function;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum PlaylistSortBy {
+    UPDATED_AT("updatedAt", Instant::parse),
+    SUBSCRIBE_COUNT("subscribeCount", Integer::parseInt),
+    ;
+    private final String sortByType;
+    private final Function<String, ?> parser;
+
+    public static PlaylistSortBy from(String text) {
+        for (PlaylistSortBy value : PlaylistSortBy.values()) {
+            if (value.getSortByType().equalsIgnoreCase(text)) {
+                return value;
+            }
+        }
+        throw new PlaylistIncorrectSortByException(text);
+    }
+
+    public Object parse(String cursor) {
+        try {
+            return parser.apply(cursor);
+        } catch (Exception ex) {
+            throw new PlaylistSortByMismatchException(sortByType, cursor);
+        }
+
+    }
+}

src/main/java/com/codeit/team5/mopl/playlist/controller/PlaylistController.java

@@ -0,0 +1,94 @@
+package com.codeit.team5.mopl.playlist.controller;
+
+import java.util.UUID;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.ModelAttribute;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import com.codeit.team5.mopl.auth.security.details.MoplPrincipal;
+import com.codeit.team5.mopl.global.dto.CursorResponse;
+import com.codeit.team5.mopl.playlist.controller.api.PlaylistControllerApi;
+import com.codeit.team5.mopl.playlist.dto.request.PlaylistCreateRequest;
+import com.codeit.team5.mopl.playlist.dto.request.PlaylistCursorRequest;
+import com.codeit.team5.mopl.playlist.dto.request.PlaylistUpdateRequest;
+import com.codeit.team5.mopl.playlist.dto.response.PlaylistResponse;
+import com.codeit.team5.mopl.playlist.mapper.PlaylistMapper;
+import com.codeit.team5.mopl.playlist.service.PlaylistService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+
+@RestController
+@RequestMapping("/api/playlists")
+@RequiredArgsConstructor
+public class PlaylistController implements PlaylistControllerApi {
+
+    private final PlaylistService service;
+    private final PlaylistMapper mapper;
+
+    @Override
+    @GetMapping("/{id}")
+    public ResponseEntity<PlaylistResponse> find(@AuthenticationPrincipal MoplPrincipal principal,
+            @PathVariable UUID id) {
+        UUID userId = principal.getId();
+        return ResponseEntity.status(HttpStatus.OK).body(service.find(id, userId));
+    }
+
+    @Override
+    @GetMapping
+    public ResponseEntity<CursorResponse<PlaylistResponse>> findCursor(
+            @AuthenticationPrincipal MoplPrincipal principal,
+            @ModelAttribute @Valid PlaylistCursorRequest request) {
+        UUID userId = principal.getId();
+        return ResponseEntity.status(HttpStatus.OK)
+                .body(service.findByCursor(mapper.toCommand(request), userId));
+    }
+
+    @Override
+    @PostMapping(consumes = MediaType.APPLICATION_JSON_VALUE)
+    public ResponseEntity<PlaylistResponse> create(@AuthenticationPrincipal MoplPrincipal principal,
+            @RequestBody @Valid PlaylistCreateRequest request) {
+        return ResponseEntity.status(HttpStatus.CREATED)
+                .body(service.create(principal.getId(), request));
+    }
+
+    @Override
+    @PatchMapping(value = "/{id}", consumes = MediaType.APPLICATION_JSON_VALUE)
+    public ResponseEntity<PlaylistResponse> update(@AuthenticationPrincipal MoplPrincipal principal,
+            @PathVariable UUID id, @RequestBody PlaylistUpdateRequest request) {
+        return ResponseEntity.status(HttpStatus.OK)
+                .body(service.update(id, principal.getId(), request));
+    }
+
+    @Override
+    @DeleteMapping("/{id}")
+    public ResponseEntity<Void> delete(@AuthenticationPrincipal MoplPrincipal principal,
+            @PathVariable UUID id) {
+        service.delete(id, principal.getId());
+        return ResponseEntity.status(HttpStatus.NO_CONTENT).build();
+    }
+
+    @Override
+    @PostMapping("/{playlistId}/contents/{contentId}")
+    public ResponseEntity<Void> addContent(@AuthenticationPrincipal MoplPrincipal principal,
+            @PathVariable UUID playlistId, @PathVariable UUID contentId) {
+        service.addContent(principal.getId(), playlistId, contentId);
+        return ResponseEntity.status(HttpStatus.NO_CONTENT).build();
+    }
+
+    @Override
+    @DeleteMapping("/{playlistId}/contents/{contentId}")
+    public ResponseEntity<Void> removeContent(@AuthenticationPrincipal MoplPrincipal principal,
+            @PathVariable UUID playlistId, @PathVariable UUID contentId) {
+        service.removeContent(principal.getId(), playlistId, contentId);
+        return ResponseEntity.status(HttpStatus.NO_CONTENT).build();
+    }
+}

src/main/java/com/codeit/team5/mopl/playlist/controller/api/PlaylistControllerApi.java

@@ -0,0 +1,49 @@
+package com.codeit.team5.mopl.playlist.controller.api;
+
+import java.util.UUID;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ModelAttribute;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestBody;
+import com.codeit.team5.mopl.auth.security.details.MoplPrincipal;
+import com.codeit.team5.mopl.global.dto.CursorResponse;
+import com.codeit.team5.mopl.playlist.dto.request.PlaylistCreateRequest;
+import com.codeit.team5.mopl.playlist.dto.request.PlaylistCursorRequest;
+import com.codeit.team5.mopl.playlist.dto.request.PlaylistUpdateRequest;
+import com.codeit.team5.mopl.playlist.dto.response.PlaylistResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+
+@Tag(name = "플레이리스트 관리")
+public interface PlaylistControllerApi {
+
+    @Operation(summary = "플레이리스트 단건 조회")
+    ResponseEntity<PlaylistResponse> find(@Parameter(hidden = true) MoplPrincipal principal,
+            @PathVariable UUID id);
+
+    @Operation(summary = "플레이리스트 목록 조회 (커서 페이지네이션)")
+    ResponseEntity<CursorResponse<PlaylistResponse>> findCursor(
+            @Parameter(hidden = true) MoplPrincipal principal,
+            @ModelAttribute PlaylistCursorRequest request);
+
+    @Operation(summary = "플레이리스트 생성", description = "생성한 플레이리스트는 API 요청자 본인의 플레이리스트로 생성됩니다.")
+    ResponseEntity<PlaylistResponse> create(@Parameter(hidden = true) MoplPrincipal principal,
+            @RequestBody PlaylistCreateRequest request);
+
+    @Operation(summary = "플레이리스트 수정", description = "플레이리스트 소유자만 수정할 수 있습니다.")
+    ResponseEntity<PlaylistResponse> update(@Parameter(hidden = true) MoplPrincipal principal,
+            @PathVariable UUID id, @RequestBody PlaylistUpdateRequest request);
+
+    @Operation(summary = "플레이리스트 삭제", description = "플레이리스트 소유자만 삭제할 수 있습니다.")
+    ResponseEntity<Void> delete(@Parameter(hidden = true) MoplPrincipal principal,
+            @PathVariable UUID playlistId);
+
+    @Operation(summary = "플레이리스트에 콘텐츠 추가", description = "플레이리스트 소유자만 콘텐츠를 추가할 수 있습니다.")
+    ResponseEntity<Void> addContent(@Parameter(hidden = true) MoplPrincipal principal,
+            @PathVariable UUID playlistId, @PathVariable UUID contentId);
+
+    @Operation(summary = "플레이리스트에서 콘텐츠 삭제", description = "플레이리스트 소유자만 콘텐츠를 삭제할 수 있습니다.")
+    ResponseEntity<Void> removeContent(@Parameter(hidden = true) MoplPrincipal principal,
+            @PathVariable UUID playlistId, @PathVariable UUID contentId);
+}

src/main/java/com/codeit/team5/mopl/playlist/dto/PlaylistContentsDto.java

@@ -0,0 +1,8 @@
+package com.codeit.team5.mopl.playlist.dto;
+
+import com.codeit.team5.mopl.content.entity.Content;
+import com.codeit.team5.mopl.playlist.entity.Playlist;
+import java.util.List;
+
+public record PlaylistContentsDto(Playlist playlist, List<Content> contents, boolean subscribedByMe) {
+}

src/main/java/com/codeit/team5/mopl/playlist/dto/PlaylistCursorCommand.java

@@ -0,0 +1,12 @@
+package com.codeit.team5.mopl.playlist.dto;
+
+import com.codeit.team5.mopl.playlist.constant.PlaylistSortBy;
+import org.springframework.data.domain.Sort;
+import java.util.UUID;
+import lombok.Builder;
+
+@Builder
+public record PlaylistCursorCommand(String keywordLike, UUID ownerIdEqual, UUID subscriberIdEqual,
+        Object cursor, UUID idAfter, Integer limit, Sort.Direction sortDirection,
+        PlaylistSortBy sortBy) {
+}

src/main/java/com/codeit/team5/mopl/playlist/dto/request/PlaylistCreateRequest.java

@@ -0,0 +1,9 @@
+package com.codeit.team5.mopl.playlist.dto.request;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+public record PlaylistCreateRequest(@NotBlank @Size(max = 255) String title,
+                                    @NotBlank String description) {
+
+}

src/main/java/com/codeit/team5/mopl/playlist/dto/request/PlaylistCursorRequest.java

@@ -0,0 +1,18 @@
+package com.codeit.team5.mopl.playlist.dto.request;
+
+import java.util.UUID;
+import org.springframework.data.domain.Sort;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Positive;
+
+public record PlaylistCursorRequest(String keywordLike,
+                                    UUID ownerIdEqual,
+                                    UUID subscriberIdEqual,
+                                    String cursor,
+                                    UUID idAfter,
+                                    @NotNull @Positive @Max(50) Integer limit,
+                                    @NotNull Sort.Direction sortDirection,
+                                    @NotNull String sortBy) {
+
+}

src/main/java/com/codeit/team5/mopl/playlist/dto/request/PlaylistUpdateRequest.java

@@ -0,0 +1,5 @@
+package com.codeit.team5.mopl.playlist.dto.request;
+
+public record PlaylistUpdateRequest(String title, String description) {
+
+}