feat : BCSD Lab 활동 api구현

src/main/java/in/koreatech/koin/domain/activity/controller/ActivityApi.java

@@ -0,0 +1,29 @@
+package in.koreatech.koin.domain.activity.controller;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import in.koreatech.koin.domain.activity.dto.ActivitiesResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+
+@Tag(name = "(Normal) Activity", description = "BCSDLab 활동")
+public interface ActivityApi {
+
+    @ApiResponses(
+        value = {
+            @ApiResponse(responseCode = "200", description = "성공적으로 활동 목록을 조회함"),
+            @ApiResponse(responseCode = "404", description = "해당하는 활동이 없음", content = @Content(schema = @Schema(hidden = true))),
+        }
+    )
+    @Operation(summary = "BCSD Lab 활동 조회")
+    @GetMapping("/activities")
+    ResponseEntity<ActivitiesResponse> getActivities(
+        @RequestParam(required = false) String year
+    );
+}

src/main/java/in/koreatech/koin/domain/activity/controller/ActivityController.java

@@ -0,0 +1,25 @@
+package in.koreatech.koin.domain.activity.controller;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import in.koreatech.koin.domain.activity.dto.ActivitiesResponse;
+import in.koreatech.koin.domain.activity.service.ActivityService;
+import lombok.RequiredArgsConstructor;
+
+@RestController
+@RequiredArgsConstructor
+public class ActivityController implements ActivityApi {
+
+    private final ActivityService activityService;
+
+    @GetMapping("/activities")
+    public ResponseEntity<ActivitiesResponse> getActivities(
+        @RequestParam(required = false) String year
+    ) {
+        ActivitiesResponse response = activityService.getActivities(year);
+        return ResponseEntity.ok(response);
+    }
+}

src/main/java/in/koreatech/koin/domain/activity/dto/ActivitiesResponse.java

@@ -0,0 +1,18 @@
+package in.koreatech.koin.domain.activity.dto;
+
+import java.util.List;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+import lombok.Getter;
+
+@Getter
+public class ActivitiesResponse {
+
+    @JsonProperty("Activities")
+    private List<ActivityResponse> activities;
+
+    public ActivitiesResponse(List<ActivityResponse> activities) {
+        this.activities = activities;
+    }
+}

src/main/java/in/koreatech/koin/domain/activity/dto/ActivityResponse.java

@@ -0,0 +1,56 @@
+package in.koreatech.koin.domain.activity.dto;
+
+import static com.fasterxml.jackson.databind.PropertyNamingStrategies.SnakeCaseStrategy;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+import com.fasterxml.jackson.databind.annotation.JsonNaming;
+
+import in.koreatech.koin.domain.activity.model.Activity;
+import io.swagger.v3.oas.annotations.media.Schema;
+
+@JsonNaming(value = SnakeCaseStrategy.class)
+public record ActivityResponse(
+    @Schema(description = "활동 날짜", example = "2019-07-29")
+    @JsonFormat(pattern = "yyyy-MM-dd")
+    LocalDate date,
+
+    @Schema(description = "삭제 여부", example = "false")
+    Boolean isDeleted,
+
+    @Schema(description = "최근 업데이트 일시", example = "2019-08-16 23:01:52")
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    LocalDateTime updatedAt,
+
+    @Schema(description = "초기 생성 일시", example = "2019-08-16 23:01:52")
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    LocalDateTime createdAt,
+
+    @Schema(description = "활동 설명", example = "더 편리한 서비스 제공을 위해 시간표 기능을 추가했습니다.")
+    String description,
+
+    @Schema(description = "이미지 URL 목록", example = "[\"https://test2.com.png\", \"https://test3.com.png]\"")
+    List<String> imageUrls,
+
+    @Schema(description = "고유 식별자", example = "1")
+    Long id,
+
+    @Schema(description = "제목", example = "코인 시간표 기능 추가")
+    String title
+) {
+    public static ActivityResponse of(Activity activity, List<String> imageUrls) {
+        return new ActivityResponse(
+            activity.getDate(),
+            activity.getIsDeleted(),
+            activity.getUpdatedAt(),
+            activity.getCreatedAt(),
+            activity.getDescription(),
+            imageUrls,
+            activity.getId(),
+            activity.getTitle()
+        );
+    }
+}

src/main/java/in/koreatech/koin/domain/activity/model/Activity.java

@@ -0,0 +1,51 @@
+package in.koreatech.koin.domain.activity.model;
+
+import java.time.LocalDate;
+
+import in.koreatech.koin.global.domain.BaseEntity;
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Table;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@Entity
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Table(name = "activities")
+public class Activity extends BaseEntity {
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name = "id")
+    private Long id;
+
+    @Column(name = "title", nullable = false)
+    private String title;
+
+    @Column(name = "description")
+    private String description;
+
+    @Column(name = "image_urls")
+    private String imageUrls;
+
+    @Column(name = "date")
+    private LocalDate date;
+
+    @Column(name = "is_deleted")
+    private Boolean isDeleted;
+
+    @Builder
+    private Activity(Long id, String title, String description, String imageUrls, LocalDate date, Boolean isDeleted) {
+        this.id = id;
+        this.title = title;
+        this.description = description;
+        this.imageUrls = imageUrls;
+        this.date = date;
+        this.isDeleted = isDeleted;
+    }
+}

src/main/java/in/koreatech/koin/domain/activity/repository/ActivityRepository.java

@@ -0,0 +1,19 @@
+package in.koreatech.koin.domain.activity.repository;
+
+import java.util.List;
+
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.Repository;
+import org.springframework.data.repository.query.Param;
+
+import in.koreatech.koin.domain.activity.model.Activity;
+
+public interface ActivityRepository extends Repository<Activity, Long> {
+
+    @Query(value = "SELECT * FROM activities WHERE is_deleted = 0 AND YEAR(date) = :year", nativeQuery = true)
+    List<Activity> getActivitiesByYear(@Param("year") String year);
+
+    List<Activity> findAllByIsDeleted(boolean isDeleted);
+
+    Activity save(Activity activity);
+}

src/main/java/in/koreatech/koin/domain/activity/service/ActivityService.java

@@ -0,0 +1,53 @@
+package in.koreatech.koin.domain.activity.service;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.stream.Collectors;
+
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import in.koreatech.koin.domain.activity.dto.ActivitiesResponse;
+import in.koreatech.koin.domain.activity.dto.ActivityResponse;
+import in.koreatech.koin.domain.activity.model.Activity;
+import in.koreatech.koin.domain.activity.repository.ActivityRepository;
+import lombok.RequiredArgsConstructor;
+
+@Service
+@RequiredArgsConstructor
+@Transactional(readOnly = true)
+public class ActivityService {
+
+    private final ActivityRepository activityRepository;
+
+    public ActivitiesResponse getActivities(String year) {
+        List<Activity> activities;
+
+        if (year == null) {
+            activities = activityRepository.findAllByIsDeleted(false);
+        } else {
+            activities = activityRepository.getActivitiesByYear(year);
+        }
+
+        List<ActivityResponse> activityResponseList = activities.stream()
+            .map(activity -> {
+                List<String> imageUrlsList = parseImageUrls(activity.getImageUrls());
+                return ActivityResponse.of(activity, imageUrlsList);
+            })
+            .collect(Collectors.toList());
+
+        return new ActivitiesResponse(activityResponseList);
+    }
+
+    private List<String> parseImageUrls(String imageUrls) {
+        if (imageUrls == null || imageUrls.trim().isEmpty()) {
+            return Collections.emptyList();
+        }
+
+        return Arrays.stream(imageUrls.split(","))
+            .map(String::trim)
+            .map(url -> url.replace("\n", "").replace("\r", "")) // 개행 문자 제거
+            .collect(Collectors.toList());
+    }
+}