[BOM-1157] feat: 마이페이지 월간 리포트 API 구현

backend/bom-bom-server/generated/openapi/me/bombom/openapi/monthlyreport/api/MonthlyReportApi.java

@@ -0,0 +1,106 @@
+/**
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech)
+ * (7.10.0). https://openapi-generator.tech Do not edit the class manually.
+ */
+package me.bombom.openapi.monthlyreport.api;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.media.ArraySchema;
+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.security.SecurityRequirement;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Generated;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.*;
+import java.util.List;
+import me.bombom.api.v1.common.resolver.LoginMember;
+import me.bombom.api.v1.member.domain.Member;
+import me.bombom.openapi.monthlyreport.model.MonthlyReportDashboardRequest;
+import me.bombom.openapi.monthlyreport.model.MonthlyReportRequest;
+import me.bombom.openapi.monthlyreport.model.ReadingCalendarDayResponse;
+import me.bombom.openapi.monthlyreport.model.ReadingDashboardResponse;
+import org.springdoc.core.annotations.ParameterObject;
+import org.springframework.http.HttpStatus;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+@Validated
+@Tag(name = "MonthlyReport", description = "월간 리포트 관련 API")
+@Generated("org.openapitools.codegen.languages.SpringCodegen")
+public interface MonthlyReportApi {
+
+  /**
+   * GET /api/v1/members/me/reading/calendar : 월간 읽기 캘린더 조회 로그인한 회원의 해당 연·월 일자별 읽기 현황을 조회합니다.
+   *
+   * @return 읽기 캘린더 조회 성공 (status code 200) or 잘못된 연·월 파라미터 요청 (status code 400) or 인증 실패 (status
+   *     code 401)
+   */
+  @Operation(
+      operationId = "getReadingCalendar",
+      summary = "월간 읽기 캘린더 조회",
+      description = "로그인한 회원의 해당 연·월 일자별 읽기 현황을 조회합니다.",
+      tags = {"MonthlyReport"},
+      responses = {
+        @ApiResponse(
+            responseCode = "200",
+            description = "읽기 캘린더 조회 성공",
+            content = {
+              @Content(
+                  mediaType = "application/json",
+                  array =
+                      @ArraySchema(
+                          schema = @Schema(implementation = ReadingCalendarDayResponse.class)))
+            }),
+        @ApiResponse(responseCode = "400", description = "잘못된 연·월 파라미터 요청"),
+        @ApiResponse(responseCode = "401", description = "인증 실패")
+      },
+      security = {@SecurityRequirement(name = "sessionCookie")})
+  @RequestMapping(
+      method = RequestMethod.GET,
+      value = "/api/v1/members/me/reading/calendar",
+      produces = {"application/json"})
+  @ResponseStatus(HttpStatus.OK)
+  List<ReadingCalendarDayResponse> getReadingCalendar(
+      @Parameter(hidden = true) @LoginMember Member member,
+      @Valid @ModelAttribute @ParameterObject MonthlyReportRequest request
+  );
+
+  /**
+   * GET /api/v1/members/me/reading/dashboard : 월간 읽기 대시보드 조회 로그인한 회원의 해당 연·월 읽기 통계를 조회합니다. 읽은 아티클
+   * 수(지난 달 대비 증감 포함), 북마크 수, 자주 읽은 뉴스레터를 반환합니다.
+   *
+   * @return 읽기 대시보드 조회 성공 (status code 200) or 잘못된 연·월 파라미터 요청 (status code 400) or 인증 실패 (status
+   *     code 401)
+   */
+  @Operation(
+      operationId = "getReadingDashboard",
+      summary = "월간 읽기 대시보드 조회",
+      description =
+          "로그인한 회원의 해당 연·월 읽기 통계를 조회합니다. 읽은 아티클 수(지난 달 대비 증감 포함), 북마크 수, 자주 읽은 뉴스레터를 반환합니다.",
+      tags = {"MonthlyReport"},
+      responses = {
+        @ApiResponse(
+            responseCode = "200",
+            description = "읽기 대시보드 조회 성공",
+            content = {
+              @Content(
+                  mediaType = "application/json",
+                  schema = @Schema(implementation = ReadingDashboardResponse.class))
+            }),
+        @ApiResponse(responseCode = "400", description = "잘못된 연·월 파라미터 요청"),
+        @ApiResponse(responseCode = "401", description = "인증 실패")
+      },
+      security = {@SecurityRequirement(name = "sessionCookie")})
+  @RequestMapping(
+      method = RequestMethod.GET,
+      value = "/api/v1/members/me/reading/dashboard",
+      produces = {"application/json"})
+  @ResponseStatus(HttpStatus.OK)
+  ReadingDashboardResponse getReadingDashboard(
+      @Parameter(hidden = true) @LoginMember Member member,
+      @Valid @ModelAttribute @ParameterObject MonthlyReportDashboardRequest request
+  );
+}

backend/bom-bom-server/generated/openapi/me/bombom/openapi/monthlyreport/model/ChangeDirection.java

@@ -0,0 +1,47 @@
+package me.bombom.openapi.monthlyreport.model;
+
+import com.fasterxml.jackson.annotation.JsonValue;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+import jakarta.annotation.Generated;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+
+/**
+ * 증감 방향
+ */
+@Generated("org.openapitools.codegen.languages.SpringCodegen")
+public enum ChangeDirection {
+
+  UP("UP"),
+  DOWN("DOWN"),
+  SAME("SAME");
+
+  private final String value;
+
+  ChangeDirection(String value) {
+    this.value = value;
+  }
+
+  @JsonValue
+  public String getValue() {
+    return value;
+  }
+
+  @Override
+  public String toString() {
+    return String.valueOf(value);
+  }
+
+  @JsonCreator
+  public static ChangeDirection fromValue(String value) {
+    for (ChangeDirection b : ChangeDirection.values()) {
+      if (b.value.equals(value)) {
+        return b;
+      }
+    }
+    throw new IllegalArgumentException("Unexpected value '" + value + "'");
+  }
+}

backend/bom-bom-server/generated/openapi/me/bombom/openapi/monthlyreport/model/FrequentReadNewsletterResponse.java

@@ -0,0 +1,45 @@
+package me.bombom.openapi.monthlyreport.model;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonCreator;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+import jakarta.annotation.Generated;
+
+/**
+ * 자주 읽은 뉴스레터 정보
+ */
+@Generated("org.openapitools.codegen.languages.SpringCodegen")
+public record FrequentReadNewsletterResponse(
+
+        @Schema(description = "순위 (1-base)", requiredMode = REQUIRED)
+        int rank,
+
+        @NotNull
+        @Schema(description = "뉴스레터 ID", requiredMode = REQUIRED)
+        Long newsletterId,
+
+        @NotNull
+        @Schema(description = "뉴스레터명", requiredMode = REQUIRED)
+        String name,
+
+        @Schema(description = "이번 달 읽은 아티클 수", requiredMode = REQUIRED)
+        long readCount
+) {
+
+    public static FrequentReadNewsletterResponse of(
+            int rank,
+            Long newsletterId,
+            String name,
+            long readCount
+    ) {
+        return new FrequentReadNewsletterResponse(
+                rank,
+                newsletterId,
+                name,
+                readCount
+        );
+    }
+}

backend/bom-bom-server/generated/openapi/me/bombom/openapi/monthlyreport/model/MonthlyReportDashboardRequest.java

@@ -0,0 +1,30 @@
+package me.bombom.openapi.monthlyreport.model;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonCreator;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+import jakarta.annotation.Generated;
+
+/**
+ * 월간 리포트 대시보드 조회 조건
+ */
+@Generated("org.openapitools.codegen.languages.SpringCodegen")
+public record MonthlyReportDashboardRequest(
+
+        @Min(1)
+        @Schema(description = "조회할 연도", requiredMode = REQUIRED)
+        int year,
+
+        @Min(1)
+        @Max(12)
+        @Schema(description = "조회할 월 (1-12)", requiredMode = REQUIRED)
+        int month,
+
+        @Min(1)
+        @Schema(description = "자주 읽은 뉴스레터 조회 개수", requiredMode = REQUIRED)
+        int limit
+) {
+}

backend/bom-bom-server/generated/openapi/me/bombom/openapi/monthlyreport/model/MonthlyReportRequest.java

@@ -0,0 +1,26 @@
+package me.bombom.openapi.monthlyreport.model;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonCreator;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+import jakarta.annotation.Generated;
+
+/**
+ * 월간 리포트 조회 조건
+ */
+@Generated("org.openapitools.codegen.languages.SpringCodegen")
+public record MonthlyReportRequest(
+
+        @Min(1)
+        @Schema(description = "조회할 연도", requiredMode = REQUIRED)
+        int year,
+
+        @Min(1)
+        @Max(12)
+        @Schema(description = "조회할 월 (1-12)", requiredMode = REQUIRED)
+        int month
+) {
+}

backend/bom-bom-server/generated/openapi/me/bombom/openapi/monthlyreport/model/ReadingCalendarDayResponse.java

@@ -0,0 +1,42 @@
+package me.bombom.openapi.monthlyreport.model;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonCreator;
+import java.time.LocalDate;
+import org.springframework.format.annotation.DateTimeFormat;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+import jakarta.annotation.Generated;
+
+/**
+ * 읽기 캘린더의 하루 정보
+ */
+@Generated("org.openapitools.codegen.languages.SpringCodegen")
+public record ReadingCalendarDayResponse(
+
+        @NotNull
+        @DateTimeFormat(iso = DateTimeFormat.ISO.DATE)
+        @Schema(description = "날짜 (yyyy-MM-dd)", requiredMode = REQUIRED)
+        LocalDate date,
+
+        @Schema(description = "해당 날짜에 아티클을 읽었는지 여부", requiredMode = REQUIRED)
+        boolean read,
+
+        @Schema(description = "해당 날짜에 읽은 아티클 수", requiredMode = REQUIRED)
+        long readCount
+) {
+
+    public static ReadingCalendarDayResponse of(
+            LocalDate date,
+            boolean read,
+            long readCount
+    ) {
+        return new ReadingCalendarDayResponse(
+                date,
+                read,
+                readCount
+        );
+    }
+}

backend/bom-bom-server/generated/openapi/me/bombom/openapi/monthlyreport/model/ReadingDashboardResponse.java

@@ -0,0 +1,53 @@
+package me.bombom.openapi.monthlyreport.model;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonValue;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+import jakarta.annotation.Generated;
+
+/**
+ * 월간 읽기 대시보드 응답
+ */
+@Generated("org.openapitools.codegen.languages.SpringCodegen")
+public record ReadingDashboardResponse(
+
+        @Schema(description = "이번 달 읽은 아티클 수", requiredMode = REQUIRED)
+        long readArticleCount,
+
+        @Schema(description = "지난 달 대비 읽은 아티클 수 증감률 (%)", requiredMode = REQUIRED)
+        Double readArticleChangeRate,
+
+        ChangeDirection readArticleChangeDirection,
+
+        @Schema(description = "북마크 개수", requiredMode = REQUIRED)
+        long bookmarkCount,
+
+        @Valid
+        @NotNull
+        @Schema(description = "자주 읽은 뉴스레터 TOP", requiredMode = REQUIRED)
+        List<FrequentReadNewsletterResponse> frequentReadNewsletters
+) {
+
+    public static ReadingDashboardResponse of(
+            long readArticleCount,
+            Double readArticleChangeRate,
+            ChangeDirection readArticleChangeDirection,
+            long bookmarkCount,
+            List<FrequentReadNewsletterResponse> frequentReadNewsletters
+    ) {
+        return new ReadingDashboardResponse(
+                readArticleCount,
+                readArticleChangeRate,
+                readArticleChangeDirection,
+                bookmarkCount,
+                frequentReadNewsletters
+        );
+    }
+}