feat: 소식지 서비스 구현

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

@@ -5,6 +5,9 @@
 import org.springframework.http.HttpStatus;
 
 import static com.example.solidconnection.application.service.ApplicationSubmissionService.APPLICATION_UPDATE_COUNT_LIMIT;
+import static com.example.solidconnection.news.service.NewsCommandService.MAX_DESCRIPTION_LENGTH;
+import static com.example.solidconnection.news.service.NewsCommandService.MAX_TITLE_LENGTH;
+import static com.example.solidconnection.news.service.NewsCommandService.MAX_URL_LENGTH;
 import static com.example.solidconnection.siteuser.service.MyPageService.MIN_DAYS_BETWEEN_NICKNAME_CHANGES;
 
 @Getter
@@ -42,6 +45,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 +100,13 @@ public enum ErrorCode {
     USER_DO_NOT_HAVE_GPA(HttpStatus.BAD_REQUEST.value(), "해당 유저의 학점을 찾을 수 없음"),
     REJECTED_REASON_REQUIRED(HttpStatus.BAD_REQUEST.value(), "거절 사유가 필요합니다."),
 
+    // news
+    NEWS_TITLE_TOO_LONG(HttpStatus.BAD_REQUEST.value(), "소식지 제목은 " + MAX_TITLE_LENGTH + "자 이하여야 합니다."),
+    NEWS_TITLE_EMPTY(HttpStatus.BAD_REQUEST.value(), "소식지 제목은 빈 값일 수 없습니다."),
+    NEWS_DESCRIPTION_TOO_LONG(HttpStatus.BAD_REQUEST.value(), "소식지 설명은 " + MAX_DESCRIPTION_LENGTH + "자 이하여야 합니다."),
+    NEWS_URL_INVALID(HttpStatus.BAD_REQUEST.value(), "올바른 URL 형식이 아닙니다."),
+    NEWS_URL_TOO_LONG(HttpStatus.BAD_REQUEST.value(), "소식지 URL은 " + MAX_URL_LENGTH + "자 이하여야 합니다."),
+
     // general
     JSON_PARSING_FAILED(HttpStatus.BAD_REQUEST.value(), "JSON 파싱을 할 수 없습니다."),
     JWT_EXCEPTION(HttpStatus.BAD_REQUEST.value(), "JWT 토큰을 처리할 수 없습니다."),

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

@@ -0,0 +1,83 @@
+package com.example.solidconnection.news.controller;
+
+import com.example.solidconnection.common.resolver.AuthorizedUser;
+import com.example.solidconnection.news.dto.NewsCreateRequest;
+import com.example.solidconnection.news.dto.NewsCommandResponse;
+import com.example.solidconnection.news.dto.NewsFindResponse;
+import com.example.solidconnection.news.dto.NewsResponse;
+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.RequireAdminAccess;
+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.PatchMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+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<NewsResponse> searchNews() {
+        NewsResponse newsResponse = newsQueryService.searchNews();
+        return ResponseEntity.ok(newsResponse);
+    }
+
+    @GetMapping(value = "/{news_id}")
+    public ResponseEntity<NewsFindResponse> findNewsById(
+            @AuthorizedUser SiteUser siteUser,
+            @PathVariable("news_id") Long newsId
+    ) {
+        NewsFindResponse newsFindResponse = newsQueryService.findNewsById(newsId);
+        return ResponseEntity.ok(newsFindResponse);
+    }
+
+    @RequireAdminAccess
+    @PostMapping
+    public ResponseEntity<NewsCommandResponse> createNews(
+            @AuthorizedUser SiteUser siteUser,
+            @Valid @RequestPart("newsCreateRequest") NewsCreateRequest newsCreateRequest,
+            @RequestParam(value = "file") MultipartFile imageFile
+    ) {
+        NewsCommandResponse newsCommandResponse = newsCommandService.createNews(newsCreateRequest, imageFile);
+        return ResponseEntity.ok(newsCommandResponse);
+    }
+
+    @RequireAdminAccess
+    @PatchMapping(value = "/{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(newsId, newsUpdateRequest, imageFile);
+        return ResponseEntity.ok(newsCommandResponse);
+    }
+
+    @RequireAdminAccess
+    @DeleteMapping(value = "/{news_id}")
+    public ResponseEntity<NewsCommandResponse> deleteNewsById(
+            @AuthorizedUser SiteUser siteUser,
+            @PathVariable("news_id") Long newsId
+    ) {
+        NewsCommandResponse newsCommandResponse = newsCommandService.deleteNewsById(newsId);
+        return ResponseEntity.ok(newsCommandResponse);
+    }
+}

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

@@ -29,4 +29,31 @@ public class News extends BaseEntity {
 
     @Column(length = 500)
     private String url;
+
+    public News(
+            String title,
+            String description,
+            String thumbnailUrl,
+            String url) {
+        this.title = title;
+        this.description = description;
+        this.thumbnailUrl = thumbnailUrl;
+        this.url = url;
+    }
+
+    public void updateTitle(String title) {
+        this.title = title;
+    }
+
+    public void updateDescription(String description) {
+        this.description = description;
+    }
+
+    public void updateUrl(String url) {
+        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,28 @@
+package com.example.solidconnection.news.dto;
+
+import com.example.solidconnection.news.domain.News;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+public record NewsCreateRequest(
+        @NotBlank(message = "소식지 제목을 입력해주세요.")
+        @Size(max = 255, message = "소식지 제목은 최대 255자 이하여야 합니다.")
+        String title,
+
+        @NotBlank(message = "소식지 설명을 입력해주세요.")
+        @Size(max = 255, message = "소식지 설명은 최대 255자 이하여야 합니다.")
+        String description,
+
+        @NotBlank(message = "소식지 URL을 입력해주세요.")
+        @Size(max = 500, message = "소식지 URL은 최대 500자 이하여야 합니다.")
+        String url
+) {
+    public News toEntity(String thumbnailUrl) {
+        return new News(
+                title,
+                description,
+                thumbnailUrl,
+                url
+        );
+    }
+}

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

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

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

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

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

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

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

@@ -0,0 +1,16 @@
+package com.example.solidconnection.news.dto;
+
+import jakarta.validation.constraints.Size;
+
+public record NewsUpdateRequest(
+
+        @Size(max = 255, message = "소식지 제목은 최대 255자 이하여야 합니다.")
+        String title,
+
+        @Size(max = 255, message = "소식지 설명은 최대 255자 이하여야 합니다.")
+        String description,
+
+        @Size(max = 500, message = "소식지 URL은 최대 500자 이하여야 합니다.")
+        String url
+) {
+}

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> findAllByOrderByUpdatedAtDesc();
+}

src/main/java/com/example/solidconnection/news/service/NewsCommandService.java

@@ -0,0 +1,101 @@
+package com.example.solidconnection.news.service;
+
+import com.example.solidconnection.common.exception.CustomException;
+import com.example.solidconnection.news.domain.News;
+import com.example.solidconnection.news.dto.NewsCreateRequest;
+import com.example.solidconnection.news.dto.NewsCommandResponse;
+import com.example.solidconnection.news.dto.NewsUpdateRequest;
+import com.example.solidconnection.news.repository.NewsRepository;
+import com.example.solidconnection.s3.domain.ImgType;
+import com.example.solidconnection.s3.dto.UploadedFileUrlResponse;
+import com.example.solidconnection.s3.service.S3Service;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.web.multipart.MultipartFile;
+
+import static com.example.solidconnection.common.exception.ErrorCode.NEWS_DESCRIPTION_TOO_LONG;
+import static com.example.solidconnection.common.exception.ErrorCode.NEWS_NOT_FOUND;
+import static com.example.solidconnection.common.exception.ErrorCode.NEWS_TITLE_EMPTY;
+import static com.example.solidconnection.common.exception.ErrorCode.NEWS_TITLE_TOO_LONG;
+import static com.example.solidconnection.common.exception.ErrorCode.NEWS_URL_INVALID;
+import static com.example.solidconnection.common.exception.ErrorCode.NEWS_URL_TOO_LONG;
+
+@Service
+@RequiredArgsConstructor
+public class NewsCommandService {
+
+    public static final int MAX_TITLE_LENGTH = 255;
+    public static final int MAX_DESCRIPTION_LENGTH = 255;
+    public static final int MAX_URL_LENGTH = 500;
+
+    private final S3Service s3Service;
+    private final NewsRepository newsRepository;
+
+    @Transactional
+    public NewsCommandResponse createNews(NewsCreateRequest newsCreateRequest, MultipartFile imageFile) {
+        UploadedFileUrlResponse uploadedFile = s3Service.uploadFile(imageFile, ImgType.NEWS);
+        News news = newsCreateRequest.toEntity(uploadedFile.fileUrl());
+        News savedNews = newsRepository.save(news);
+        return NewsCommandResponse.from(savedNews);
+    }
+
+    @Transactional
+    public NewsCommandResponse updateNews(Long newsId, NewsUpdateRequest newsUpdateRequest, MultipartFile imageFile) {
+        News news = newsRepository.findById(newsId)
+                .orElseThrow(() -> new CustomException(NEWS_NOT_FOUND));
+        if (newsUpdateRequest.title() != null) {
+            validateTitle(newsUpdateRequest.title());
+            news.updateTitle(newsUpdateRequest.title());
+        }
+        if (newsUpdateRequest.description() != null) {
+            validateDescription(newsUpdateRequest.description());
+            news.updateDescription(newsUpdateRequest.description());
+        }
+        if (newsUpdateRequest.url() != null) {
+            validateUrl(newsUpdateRequest.url());
+            news.updateUrl(newsUpdateRequest.url());
+        }
+        if (imageFile != null) {
+            UploadedFileUrlResponse uploadedFile = s3Service.uploadFile(imageFile, ImgType.NEWS);
+            s3Service.deletePostImage(news.getThumbnailUrl());
+            String thumbnailImageUrl = uploadedFile.fileUrl();
+            news.updateThumbnailUrl(thumbnailImageUrl);
+        }
+        News savedNews = newsRepository.save(news);
+        return NewsCommandResponse.from(savedNews);
+    }
+
+    @Transactional
+    public NewsCommandResponse deleteNewsById(Long newsId) {
+        News news = newsRepository.findById(newsId)
+                .orElseThrow(() -> new CustomException(NEWS_NOT_FOUND));
+        newsRepository.deleteById(newsId);
+        s3Service.deletePostImage(news.getThumbnailUrl());
+        return NewsCommandResponse.from(news);
+    }
+
+    private void validateTitle(String title) {
+        if (title.trim().isEmpty()) {
+            throw new CustomException(NEWS_TITLE_EMPTY);
+        }
+        if (title.length() > MAX_TITLE_LENGTH) {
+            throw new CustomException(NEWS_TITLE_TOO_LONG);
+        }
+    }
+
+    private void validateDescription(String description) {
+        if (description.length() > MAX_DESCRIPTION_LENGTH) {
+            throw new CustomException(NEWS_DESCRIPTION_TOO_LONG);
+        }
+    }
+
+    private void validateUrl(String url) {
+        if (!url.matches("^https?://.*")) {
+            throw new CustomException(NEWS_URL_INVALID);
+        }
+        if (url.length() > MAX_URL_LENGTH) {
+            throw new CustomException(NEWS_URL_TOO_LONG);
+        }
+    }
+}