[feat] 다솜소식 API 구현

src/main/java/dmu/dasom/api/domain/news/controller/NewsController.java

@@ -0,0 +1,52 @@
+package dmu.dasom.api.domain.news.controller;
+
+import dmu.dasom.api.domain.news.dto.NewsRequestDto;
+import dmu.dasom.api.domain.news.dto.NewsResponseDto;
+import dmu.dasom.api.domain.news.service.NewsService;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.ExampleObject;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+import jakarta.validation.Valid;
+import java.util.List;
+
+@Tag(name = "NEWS API", description = "다솜소식 API")
+@RestController
+@RequestMapping("/api/news")
+public class NewsController {
+
+    private final NewsService newsService;
+
+    public NewsController(NewsService newsService) {
+        this.newsService = newsService;
+    }
+
+    @Operation(summary = "소식 조회", description = "리스트로 조회")
+    @ApiResponse(responseCode = "200", description = "정상 응답",
+            content = @Content(mediaType = "application/json"))
+    @GetMapping
+    public ResponseEntity<List<NewsResponseDto>> getAllNews() {
+        List<NewsResponseDto> newsList = newsService.getAllNews();
+        return ResponseEntity.ok(newsList);
+    }
+
+    @Operation(summary = "소식 등록", description = "새로운 소식을 등록")
+    @ApiResponses(value = {
+            @ApiResponse(responseCode = "201", description = "생성 완료"),
+            @ApiResponse(responseCode = "400", description = "유효하지 않은 요청 데이터",
+                    content = @Content(mediaType = "application/json",
+                            examples = @ExampleObject(value = "{ \"errorCode\": \"E003\", \"errorMessage\": \"유효하지 않은 입력입니다.\" }")))
+    })
+
+    @PostMapping
+    public ResponseEntity<NewsResponseDto> createNews(@Valid @RequestBody NewsRequestDto requestDto) {
+        NewsResponseDto responseDto = newsService.createNews(requestDto);
+        return ResponseEntity.status(201).body(responseDto);
+    }
+
+}

src/main/java/dmu/dasom/api/domain/news/dto/NewsRequestDto.java

@@ -0,0 +1,24 @@
+package dmu.dasom.api.domain.news.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.Getter;
+
+@Getter
+@Schema(name = "NewsRequestDto", description = "뉴스 생성 요청 DTO")
+public class NewsRequestDto {
+
+    @NotBlank
+    @Size(max = 100)
+    @Schema(description = "뉴스 제목", example = "새로운 뉴스 제목")
+    private String title;
+
+    @NotBlank
+    @Schema(description = "뉴스 내용", example = "새로운 뉴스 내용")
+    private String content;
+
+    @Size(max = 255)
+    @Schema(description = "뉴스 이미지 URL", example = "http://example.com/image.jpg", nullable = true)
+    private String imageUrl;
+}

src/main/java/dmu/dasom/api/domain/news/dto/NewsResponseDto.java

@@ -0,0 +1,34 @@
+package dmu.dasom.api.domain.news.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Getter;
+
+import java.time.LocalDateTime;
+
+@Getter
+@Schema(name = "NewsResponseDto", description = "뉴스 응답 DTO")
+public class NewsResponseDto {
+
+    @Schema(description = "소식 ID", example = "1")
+    private final Long id;
+
+    @Schema(description = "뉴스 제목", example = "제목")
+    private final String title;
+
+    @Schema(description = "뉴스 내용", example = "내용")
+    private final String content;
+
+    @Schema(description = "작성일", example = "2025-02-14T12:00:00")
+    private final LocalDateTime createdAt;
+
+    @Schema(description = "뉴스 이미지 URL", example = "http://example.com/image.jpg", nullable = true)
+    private final String imageUrl;
+
+    public NewsResponseDto(Long id, String title, String content, LocalDateTime createdAt, String imageUrl) {
+        this.id = id;
+        this.title = title;
+        this.content = content;
+        this.createdAt = createdAt;
+        this.imageUrl = imageUrl;
+    }
+}

src/main/java/dmu/dasom/api/domain/news/entity/NewsEntity.java

@@ -0,0 +1,48 @@
+package dmu.dasom.api.domain.news.entity;
+
+import dmu.dasom.api.domain.common.BaseEntity;
+import dmu.dasom.api.domain.common.Status;
+import dmu.dasom.api.domain.news.dto.NewsResponseDto;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.persistence.*;
+import jakarta.validation.constraints.NotNull;
+import lombok.*;
+
+@Getter
+@Setter
+@Entity
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+@Schema(description = "뉴스 엔티티")
+public class NewsEntity extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Schema(description = "뉴스 ID", example = "1")
+    private Long id;
+
+    @NotNull
+    @Schema(description = "뉴스 제목", example = "뉴스 예제 제목")
+    @Column(nullable = false, length = 100)
+    private String title;
+
+    @NotNull
+    @Schema(description = "뉴스 내용", example = "뉴스 예제 내용")
+    @Column(columnDefinition = "TEXT", nullable = false)
+    private String content;
+
+    @Schema(description = "뉴스 이미지 URL", example = "http://example.com/image.jpg")
+    @Column(length = 255)
+    private String imageUrl;
+
+    // 🔹 뉴스 상태 업데이트
+    public void updateStatus(Status status) {
+        super.updateStatus(status);
+    }
+
+    // 🔹 NewsEntity → NewsResponseDto 변환
+    public NewsResponseDto toResponseDto() {
+        return new NewsResponseDto(id, title, content, getCreatedAt(), imageUrl);
+    }
+}

src/main/java/dmu/dasom/api/domain/news/repository/NewsRepository.java

@@ -0,0 +1,9 @@
+package dmu.dasom.api.domain.news.repository;
+
+import dmu.dasom.api.domain.news.entity.NewsEntity;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface NewsRepository extends JpaRepository<NewsEntity, Long> {
+}

src/main/java/dmu/dasom/api/domain/news/service/NewsService.java

@@ -0,0 +1,38 @@
+package dmu.dasom.api.domain.news.service;
+
+import dmu.dasom.api.domain.news.dto.NewsRequestDto;
+import dmu.dasom.api.domain.news.dto.NewsResponseDto;
+import dmu.dasom.api.domain.news.entity.NewsEntity;
+import dmu.dasom.api.domain.news.repository.NewsRepository;
+import org.springframework.stereotype.Service;
+import java.util.List;
+import java.util.stream.Collectors;
+
+@Service
+public class NewsService {
+
+    private final NewsRepository newsRepository;
+
+    public NewsService(NewsRepository newsRepository) {
+        this.newsRepository = newsRepository;
+    }
+
+    // 🔹 전체 조회
+    public List<NewsResponseDto> getAllNews() {
+        return newsRepository.findAll().stream()
+                .map(NewsEntity::toResponseDto)
+                .collect(Collectors.toList());
+    }
+
+    // 🔹 생성
+    public NewsResponseDto createNews(NewsRequestDto requestDto) {
+        NewsEntity news = NewsEntity.builder()
+                .title(requestDto.getTitle())
+                .content(requestDto.getContent())
+                .imageUrl(requestDto.getImageUrl())
+                .build();
+
+        NewsEntity savedNews = newsRepository.save(news);
+        return savedNews.toResponseDto();
+    }
+}