feat: 콘텐츠 관리 - 사전 클래스 작성 및 콘텐츠 등록

build.gradle

@@ -28,7 +28,7 @@ dependencies {
     implementation 'org.springframework.boot:spring-boot-starter-data-redis'
     implementation 'org.flywaydb:flyway-core'
     implementation 'org.flywaydb:flyway-database-postgresql'
-    implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.6.0'
+    implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.17'
     implementation 'org.mapstruct:mapstruct:1.6.3'
     // Spring security
     implementation 'org.springframework.boot:spring-boot-starter-security'

src/main/java/com/codeit/team5/mopl/content/controller/ContentController.java

@@ -0,0 +1,37 @@
+package com.codeit.team5.mopl.content.controller;
+
+import com.codeit.team5.mopl.content.controller.api.ContentApi;
+import com.codeit.team5.mopl.content.dto.request.ContentCreateRequest;
+import com.codeit.team5.mopl.content.dto.response.ContentResponse;
+import com.codeit.team5.mopl.content.service.ContentService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestPart;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.multipart.MultipartFile;
+
+@RestController
+@RequestMapping("/api/contents")
+@RequiredArgsConstructor
+@Slf4j
+public class ContentController implements ContentApi {
+
+    private final ContentService contentService;
+
+    @Override
+    @PostMapping(consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+    public ResponseEntity<ContentResponse> postContent(
+            @Valid @RequestPart("request") ContentCreateRequest request,
+            @RequestPart(value = "thumbnail", required = false) MultipartFile thumbnail
+    ) {
+        log.info("Content Create request: POST /api/contents");
+        ContentResponse response = contentService.create(request, thumbnail);
+        return ResponseEntity.status(HttpStatus.CREATED).body(response);
+    }
+}

src/main/java/com/codeit/team5/mopl/content/controller/api/ContentApi.java

@@ -0,0 +1,53 @@
+package com.codeit.team5.mopl.content.controller.api;
+
+import com.codeit.team5.mopl.content.dto.request.ContentCreateRequest;
+import com.codeit.team5.mopl.content.dto.response.ContentResponse;
+import com.codeit.team5.mopl.global.dto.ErrorResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Encoding;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.parameters.RequestBody;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.multipart.MultipartFile;
+
+@Tag(name = "콘텐츠 관리", description = "콘텐츠 관련 API")
+public interface ContentApi {
+
+    @Schema(name = "ContentCreateMultipartRequest")
+    class MultipartRequest {
+        @Schema(implementation = ContentCreateRequest.class)
+        public ContentCreateRequest request;
+
+        @Schema(type = "string", format = "binary", description = "썸네일 이미지")
+        public MultipartFile thumbnail;
+    }
+
+    @Operation(summary = "[어드민] 콘텐츠 생성", description = "새로운 콘텐츠를 등록합니다.")
+    @ApiResponses({
+            @ApiResponse(responseCode = "201", description = "성공",
+                    content = @Content(schema = @Schema(implementation = ContentResponse.class))),
+            @ApiResponse(responseCode = "400", description = "잘못된 요청",
+                    content = @Content(schema = @Schema(implementation = ErrorResponse.class))),
+            @ApiResponse(responseCode = "401", description = "인증 오류",
+                    content = @Content(schema = @Schema(implementation = ErrorResponse.class))),
+            @ApiResponse(responseCode = "403", description = "권한 오류",
+                    content = @Content(schema = @Schema(implementation = ErrorResponse.class))),
+            @ApiResponse(responseCode = "500", description = "서버 오류",
+                    content = @Content(schema = @Schema(implementation = ErrorResponse.class)))
+    })
+    @RequestBody(content = @Content(
+            mediaType = MediaType.MULTIPART_FORM_DATA_VALUE,
+            schema = @Schema(implementation = MultipartRequest.class),
+            encoding = @Encoding(name = "request", contentType = MediaType.APPLICATION_JSON_VALUE)
+    ))
+    ResponseEntity<ContentResponse> postContent(
+            @Parameter(hidden = true) ContentCreateRequest request,
+            @Parameter(hidden = true) MultipartFile thumbnail
+    );
+}

src/main/java/com/codeit/team5/mopl/content/dto/request/ContentCreateRequest.java

@@ -0,0 +1,24 @@
+package com.codeit.team5.mopl.content.dto.request;
+
+import com.codeit.team5.mopl.content.entity.ContentType;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import java.util.List;
+
+public record ContentCreateRequest(
+        @NotNull(message = "콘텐츠 타입은 필수입니다.")
+        ContentType type,
+
+        @NotBlank(message = "제목은 필수입니다.")
+        @Size(max = 500, message = "제목은 500자를 초과할 수 없습니다.")
+        String title,
+
+        String description,
+
+        @NotNull(message = "콘텐츠 태그는 필수 입니다.")
+        @NotEmpty(message = "콘텐츠 태그 목록은 비어있을 수 없습니다.")
+        List<@NotBlank(message = "태그는 공백일 수 없습니다.") String> tags
+) {
+}

src/main/java/com/codeit/team5/mopl/content/dto/response/ContentResponse.java

@@ -0,0 +1,18 @@
+package com.codeit.team5.mopl.content.dto.response;
+
+import com.codeit.team5.mopl.content.entity.ContentType;
+import java.util.List;
+import java.util.UUID;
+
+public record ContentResponse(
+        UUID id,
+        ContentType type,
+        String title,
+        String description,
+        String thumbnailUrl,
+        List<String> tags,
+        double averageRating,
+        int reviewCount,
+        long watcherCount
+) {
+}

src/main/java/com/codeit/team5/mopl/content/entity/Content.java

@@ -1,59 +1,116 @@
 package com.codeit.team5.mopl.content.entity;
 
+import com.codeit.team5.mopl.content.exception.InvalidContentSourceException;
 import com.codeit.team5.mopl.global.entity.BaseUpdatableEntity;
+import com.codeit.team5.mopl.tag.entity.Tag;
+import jakarta.persistence.CascadeType;
 import jakarta.persistence.Column;
 import jakarta.persistence.Entity;
+import jakarta.persistence.EnumType;
+import jakarta.persistence.Enumerated;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.OneToMany;
 import jakarta.persistence.Table;
-import jakarta.validation.constraints.NotNull;
-import jakarta.validation.constraints.Size;
+import jakarta.persistence.UniqueConstraint;
 import java.time.Instant;
-import java.util.Map;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.UUID;
+import lombok.AccessLevel;
 import lombok.Getter;
-import lombok.Setter;
+import lombok.NoArgsConstructor;
 import org.hibernate.annotations.JdbcTypeCode;
 import org.hibernate.type.SqlTypes;
 
 @Getter
-@Setter
 @Entity
-@Table(name = "contents")
+@Table(
+        name = "contents",
+        uniqueConstraints = {
+                @UniqueConstraint(
+                        name = "uk_contents_source_external_id",
+                        columnNames = {"source", "external_id"}
+                )
+        }
+)
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
 public class Content extends BaseUpdatableEntity {
 
-    @Size(max = 20)
-    @NotNull
-    @Column(name = "type", nullable = false, length = 20)
-    private String type;
+    @Enumerated(EnumType.STRING)
+    @Column(nullable = false, length = 20)
+    private ContentType type;
 
-    @Size(max = 500)
-    @NotNull
-    @Column(name = "title", nullable = false, length = 500)
+    @Column(nullable = false, length = 500)
     private String title;
 
-    @Column(name = "description", length = Integer.MAX_VALUE)
+    @Column(columnDefinition = "TEXT")
     private String description;
 
-    @Size(max = 512)
     @Column(name = "thumbnail_url", length = 512)
     private String thumbnailUrl;
 
     @Column(name = "released_at")
     private Instant releasedAt;
 
     @JdbcTypeCode(SqlTypes.JSON)
-    @Column(name = "metadata")
-    private Map<String, Object> metadata;
+    @Column(columnDefinition = "JSONB")
+    private String metadata;
 
-    @Size(max = 20)
-    @NotNull
-    @Column(name = "source", nullable = false, length = 20)
-    private String source;
+    @Enumerated(EnumType.STRING)
+    @Column(nullable = false, length = 20)
+    private ContentSource source;
 
-    @Size(max = 100)
-    @NotNull
     @Column(name = "external_id", nullable = false, length = 100)
     private String externalId;
 
-    @NotNull
-    @Column(name = "updated_at", nullable = false)
-    private Instant updatedAt;
+    @OneToMany(mappedBy = "content", fetch = FetchType.LAZY, cascade = CascadeType.ALL, orphanRemoval = true)
+    private List<ContentTag> contentTags = new ArrayList<>();
+
+    public static Content createByAdmin(ContentType type, String title, String description) {
+        Content content = new Content();
+        content.type = type;
+        content.title = title;
+        content.description = description;
+        content.source = ContentSource.ADMIN;
+        content.externalId = UUID.randomUUID().toString();
+        return content;
+    }
+
+    public static Content createByExternalSource(ContentType type, String title, String description,
+            ContentSource source, String externalId, Instant releasedAt, String metadata) {
+        if (source == null || source == ContentSource.ADMIN) {
+            throw new InvalidContentSourceException("외부 소스 생성에 ADMIN 소스는 사용할 수 없습니다.");
+        }
+        if (externalId == null || externalId.isBlank()) {
+            throw new InvalidContentSourceException("외부 소스 콘텐츠는 externalId가 필수입니다.");
+        }
+        Content content = new Content();
+        content.type = type;
+        content.title = title;
+        content.description = description;
+        content.source = source;
+        content.externalId = externalId;
+        content.releasedAt = releasedAt;
+        content.metadata = metadata;
+        return content;
+    }
+
+    public void addTag(Tag tag) {
+        if (tag == null) {
+            return;
+        }
+
+        boolean alreadyExists = this.contentTags.stream()
+                .anyMatch(ct -> {
+                    Tag existing = ct.getTag();
+                    if (existing.getId() != null && tag.getId() != null) {
+                        return existing.getId().equals(tag.getId());
+                    }
+                    return existing.getName().equals(tag.getName());
+                });
+
+        if (!alreadyExists) {
+            contentTags.add(ContentTag.create(this, tag));
+        }
+    }
 }

src/main/java/com/codeit/team5/mopl/content/entity/ContentSource.java

@@ -0,0 +1,7 @@
+package com.codeit.team5.mopl.content.entity;
+
+public enum ContentSource {
+    TMDB,
+    SPORTS_DB,
+    ADMIN
+}

src/main/java/com/codeit/team5/mopl/content/entity/ContentStats.java

@@ -0,0 +1,58 @@
+package com.codeit.team5.mopl.content.entity;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.Id;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.MapsId;
+import jakarta.persistence.OneToOne;
+import jakarta.persistence.PreUpdate;
+import jakarta.persistence.Table;
+import java.time.Instant;
+import java.util.UUID;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@Entity
+@Table(name = "content_stats")
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class ContentStats {
+
+    @Id
+    private UUID contentId;
+
+    @MapsId
+    @OneToOne(fetch = FetchType.LAZY, optional = false)
+    @JoinColumn(name = "content_id")
+    private Content content;
+
+    @Column(nullable = false)
+    private int reviewCount;
+
+    @Column(nullable = false)
+    private double ratingSum;
+
+    @Column(nullable = false)
+    private long watcherCount;
+
+    @Column(nullable = false)
+    private Instant updatedAt;
+
+    @PreUpdate
+    protected void onUpdate() {
+        this.updatedAt = Instant.now();
+    }
+
+    public static ContentStats create(Content content) {
+        ContentStats stats = new ContentStats();
+        stats.content = content;
+        stats.reviewCount = 0;
+        stats.ratingSum = 0.0;
+        stats.watcherCount = 0;
+        stats.updatedAt = Instant.now();
+        return stats;
+    }
+}