feat: 소식지 서비스 구현

src/main/java/com/example/solidconnection/application/controller/ApplicationController.java

@@ -6,7 +6,8 @@
 import com.example.solidconnection.application.service.ApplicationQueryService;
 import com.example.solidconnection.application.service.ApplicationSubmissionService;
 import com.example.solidconnection.common.resolver.AuthorizedUser;
-import com.example.solidconnection.security.annotation.RequireAdminAccess;
+import com.example.solidconnection.security.annotation.RequireRoleAccess;
+import com.example.solidconnection.siteuser.domain.Role;
 import com.example.solidconnection.siteuser.domain.SiteUser;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
@@ -39,7 +40,7 @@ public ResponseEntity<ApplicationSubmissionResponse> apply(
                 .body(applicationSubmissionResponse);
     }
 
-    @RequireAdminAccess
+    @RequireRoleAccess(roles = {Role.ADMIN})
     @GetMapping
     public ResponseEntity<ApplicationsResponse> getApplicants(
             @AuthorizedUser SiteUser siteUser,

src/main/java/com/example/solidconnection/common/exception/ErrorCode.java

@@ -42,6 +42,7 @@ public enum ErrorCode {
     COUNTRY_NOT_FOUND_BY_KOREAN_NAME(HttpStatus.NOT_FOUND.value(), "이름에 해당하는 국가를 찾을 수 없습니다."),
     GPA_SCORE_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "존재하지 않는 학점입니다."),
     LANGUAGE_TEST_SCORE_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "존재하지 않는 어학성적입니다."),
+    NEWS_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "존재하지 않는 소식지입니다."),
 
     // auth
     USER_ALREADY_SIGN_OUT(HttpStatus.UNAUTHORIZED.value(), "로그아웃 되었습니다."),
@@ -96,6 +97,10 @@ public enum ErrorCode {
     USER_DO_NOT_HAVE_GPA(HttpStatus.BAD_REQUEST.value(), "해당 유저의 학점을 찾을 수 없음"),
     REJECTED_REASON_REQUIRED(HttpStatus.BAD_REQUEST.value(), "거절 사유가 필요합니다."),
 
+    // news
+    INVALID_NEWS_ACCESS(HttpStatus.BAD_REQUEST.value(), "자신의 소식지만 제어할 수 있습니다."),
+
+
     // database
     DATA_INTEGRITY_VIOLATION(HttpStatus.CONFLICT.value(), "데이터베이스 무결성 제약조건 위반이 발생했습니다."),
 

src/main/java/com/example/solidconnection/news/config/NewsProperties.java

@@ -0,0 +1,9 @@
+package com.example.solidconnection.news.config;
+
+import org.springframework.boot.context.properties.ConfigurationProperties;
+
+@ConfigurationProperties(prefix = "news")
+public record NewsProperties(
+        String defaultThumbnailUrl
+) {
+}

src/main/java/com/example/solidconnection/news/controller/NewsController.java

@@ -0,0 +1,80 @@
+package com.example.solidconnection.news.controller;
+
+import com.example.solidconnection.common.resolver.AuthorizedUser;
+import com.example.solidconnection.news.dto.NewsCommandResponse;
+import com.example.solidconnection.news.dto.NewsCreateRequest;
+import com.example.solidconnection.news.dto.NewsListResponse;
+import com.example.solidconnection.news.dto.NewsUpdateRequest;
+import com.example.solidconnection.news.service.NewsCommandService;
+import com.example.solidconnection.news.service.NewsQueryService;
+import com.example.solidconnection.security.annotation.RequireRoleAccess;
+import com.example.solidconnection.siteuser.domain.Role;
+import com.example.solidconnection.siteuser.domain.SiteUser;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RequestPart;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.multipart.MultipartFile;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/news")
+public class NewsController {
+
+    private final NewsQueryService newsQueryService;
+    private final NewsCommandService newsCommandService;
+
+    // todo: 추후 Slice 적용
+    @GetMapping
+    public ResponseEntity<NewsListResponse> findNewsBySiteUserId(
+            @RequestParam(value = "site-user-id") Long siteUserId
+    ) {
+        NewsListResponse newsListResponse = newsQueryService.findNewsBySiteUserId(siteUserId);
+        return ResponseEntity.ok(newsListResponse);
+    }
+
+    @RequireRoleAccess(roles = {Role.ADMIN, Role.MENTOR})
+    @PostMapping
+    public ResponseEntity<NewsCommandResponse> createNews(
+            @AuthorizedUser SiteUser siteUser,
+            @Valid @RequestPart("newsCreateRequest") NewsCreateRequest newsCreateRequest,
+            @RequestParam(value = "file", required = false) MultipartFile imageFile
+    ) {
+        NewsCommandResponse newsCommandResponse = newsCommandService.createNews(siteUser.getId(), newsCreateRequest, imageFile);
+        return ResponseEntity.ok(newsCommandResponse);
+    }
+
+    @RequireRoleAccess(roles = {Role.ADMIN, Role.MENTOR})
+    @PutMapping("/{news-id}")
+    public ResponseEntity<NewsCommandResponse> updateNews(
+            @AuthorizedUser SiteUser siteUser,
+            @PathVariable("news-id") Long newsId,
+            @Valid @RequestPart(value = "newsUpdateRequest") NewsUpdateRequest newsUpdateRequest,
+            @RequestParam(value = "file", required = false) MultipartFile imageFile
+    ) {
+        NewsCommandResponse newsCommandResponse = newsCommandService.updateNews(
+                siteUser.getId(),
+                newsId,
+                newsUpdateRequest,
+                imageFile);
+        return ResponseEntity.ok(newsCommandResponse);
+    }
+
+    @RequireRoleAccess(roles = {Role.ADMIN, Role.MENTOR})
+    @DeleteMapping("/{news-id}")
+    public ResponseEntity<NewsCommandResponse> deleteNewsById(
+            @AuthorizedUser SiteUser siteUser,
+            @PathVariable("news-id") Long newsId
+    ) {
+        NewsCommandResponse newsCommandResponse = newsCommandService.deleteNewsById(siteUser, newsId);
+        return ResponseEntity.ok(newsCommandResponse);
+    }
+}

src/main/java/com/example/solidconnection/news/domain/News.java

@@ -6,13 +6,16 @@
 import jakarta.persistence.GeneratedValue;
 import jakarta.persistence.GenerationType;
 import jakarta.persistence.Id;
+import lombok.AccessLevel;
+import lombok.AllArgsConstructor;
 import lombok.EqualsAndHashCode;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 
-@Getter
 @Entity
-@NoArgsConstructor
+@Getter
+@AllArgsConstructor
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
 @EqualsAndHashCode
 public class News extends BaseEntity {
 
@@ -29,4 +32,29 @@ public class News extends BaseEntity {
 
     @Column(length = 500)
     private String url;
+
+    private long siteUserId;
+
+    public News(
+            String title,
+            String description,
+            String thumbnailUrl,
+            String url,
+            long siteUserId) {
+        this.title = title;
+        this.description = description;
+        this.thumbnailUrl = thumbnailUrl;
+        this.url = url;
+        this.siteUserId = siteUserId;
+    }
+
+    public void updateNews(String title, String description, String url) {
+        this.title = title;
+        this.description = description;
+        this.url = url;
+    }
+
+    public void updateThumbnailUrl(String thumbnailUrl) {
+        this.thumbnailUrl = thumbnailUrl;
+    }
 }

src/main/java/com/example/solidconnection/news/dto/NewsCommandResponse.java

@@ -0,0 +1,13 @@
+package com.example.solidconnection.news.dto;
+
+import com.example.solidconnection.news.domain.News;
+
+public record NewsCommandResponse(
+        long id
+) {
+    public static NewsCommandResponse from(News news) {
+        return new NewsCommandResponse(
+                news.getId()
+        );
+    }
+}

src/main/java/com/example/solidconnection/news/dto/NewsCreateRequest.java

@@ -0,0 +1,31 @@
+package com.example.solidconnection.news.dto;
+
+import com.example.solidconnection.news.domain.News;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import org.hibernate.validator.constraints.URL;
+
+public record NewsCreateRequest(
+        @NotBlank(message = "소식지 제목을 입력해주세요.")
+        @Size(max = 20, message = "소식지 제목은 20자 이하여야 합니다.")
+        String title,
+
+        @NotBlank(message = "소식지 내용을 입력해주세요.")
+        @Size(max = 30, message = "소식지 내용은 30자 이하여야 합니다.")
+        String description,
+
+        @NotBlank(message = "소식지 URL을 입력해주세요.")
+        @Size(max = 500, message = "소식지 URL은 500자 이하여야 합니다.")
+        @URL(message = "올바른 URL 형식이 아닙니다.")
+        String url
+) {
+    public News toEntity(String thumbnailUrl, long siteUserId) {
+        return new News(
+                title,
+                description,
+                thumbnailUrl,
+                url,
+                siteUserId
+        );
+    }
+}

src/main/java/com/example/solidconnection/news/dto/NewsListResponse.java

@@ -0,0 +1,11 @@
+package com.example.solidconnection.news.dto;
+
+import java.util.List;
+
+public record NewsListResponse(
+        List<NewsResponse> newsResponseList
+) {
+    public static NewsListResponse from(List<NewsResponse> newsResponseList) {
+        return new NewsListResponse(newsResponseList);
+    }
+}

src/main/java/com/example/solidconnection/news/dto/NewsResponse.java

@@ -0,0 +1,25 @@
+package com.example.solidconnection.news.dto;
+
+import com.example.solidconnection.news.domain.News;
+
+import java.time.ZonedDateTime;
+
+public record NewsResponse(
+        long id,
+        String title,
+        String description,
+        String thumbnailUrl,
+        String url,
+        ZonedDateTime updatedAt
+) {
+    public static NewsResponse from(News news) {
+        return new NewsResponse(
+                news.getId(),
+                news.getTitle(),
+                news.getDescription(),
+                news.getThumbnailUrl(),
+                news.getUrl(),
+                news.getUpdatedAt()
+        );
+    }
+}

src/main/java/com/example/solidconnection/news/dto/NewsUpdateRequest.java

@@ -0,0 +1,23 @@
+package com.example.solidconnection.news.dto;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import org.hibernate.validator.constraints.URL;
+
+public record NewsUpdateRequest(
+        @NotBlank(message = "소식지 제목을 입력해주세요.")
+        @Size(max = 20, message = "소식지 제목은 20자 이하여야 합니다.")
+        String title,
+
+        @NotBlank(message = "소식지 내용을 입력해주세요.")
+        @Size(max = 30, message = "소식지 내용은 30자 이하여야 합니다.")
+        String description,
+
+        @NotBlank(message = "소식지 URL을 입력해주세요.")
+        @Size(max = 500, message = "소식지 URL은 500자 이하여야 합니다.")
+        @URL(message = "올바른 URL 형식이 아닙니다.")
+        String url,
+
+        Boolean resetToDefaultImage
+) {
+}

src/main/java/com/example/solidconnection/news/repository/NewsRepository.java

@@ -0,0 +1,11 @@
+package com.example.solidconnection.news.repository;
+
+import com.example.solidconnection.news.domain.News;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.List;
+
+public interface NewsRepository extends JpaRepository<News, Long> {
+
+    List<News> findAllBySiteUserIdOrderByUpdatedAtDesc(long siteUserId);
+}