[FEAT] 월간 캘린더 시간형 실행 항목 조회 API 추가

src/main/java/com/tryna/domain/action/controller/ActionItemController.java

@@ -181,4 +181,35 @@ public ResponseEntity<ApiResponse<TimedActionItemResponse>> getTimedActionItems(
                 )
         );
     }
-}
+
+    /**
+     * F104-2: 월간 캘린더 내 시간형 실행 항목 조회
+     */
+    @GetMapping("/calendar/action-items/timed/monthly")
+    @Override
+    public ResponseEntity<ApiResponse<MonthlyTimedActionItemResponse>> getMonthlyTimedActionItems(
+            @RequestParam("year") Integer year,
+            @RequestParam("month") Integer month
+    ) {
+        // 1. SecurityContext에서 현재 사용자 ID 추출
+        Long userId = extractUserIdFromSecurityContext();
+
+        // 2. 인증 정보가 없는 경우 인증 예외 처리
+        if (userId == null) {
+            throw new BusinessException(AuthErrorCode.AUTH_401);
+        }
+
+        // 3. 조회 연월의 시간형 실행 항목을 날짜별로 조회
+        MonthlyTimedActionItemResponse response =
+                actionItemService.getMonthlyTimedActionItems(userId, year, month);
+
+        // 4. 공통 응답 형식으로 반환
+        return ResponseEntity.ok(
+                ApiResponse.success(
+                        "F104_ACTION_ITEM_200",
+                        "월간 시간형 실행 항목 조회에 성공했습니다.",
+                        response
+                )
+        );
+    }
+}

src/main/java/com/tryna/domain/action/controller/docs/ActionItemControllerDocs.java

@@ -92,4 +92,33 @@ ResponseEntity<ApiResponse<TimedActionItemResponse>> getTimedActionItems(
             )
             @RequestParam("date") String date
     );
+
+    @Operation(
+            summary = "F104-2 월간 캘린더 내 시간형 실행 항목 조회",
+            description = """
+                    조회 연월에 displayDate가 포함되는 시간형 실행 항목을 반환합니다.
+                    부모 일정 날짜와 관계없이 계산된 displayDate를 기준으로 월 포함 여부를 판단하며,
+                    현재 사용자의 CONFIRMED 또는 NEEDS_CONFIRMATION 일정에 연결된 TIMED_ACTION만 포함합니다.
+                    삭제된 항목과 삭제된 반복 회차는 제외하고, 반복 항목은 offsetDays와 회차별 상태를 반영합니다.
+                    각 항목에는 부모 일정의 labelId와 상세 이동에 사용할 parentOccurrenceDate가 포함됩니다.
+                    회원과 비회원 모두 유효한 Bearer 토큰으로 호출할 수 있습니다.
+                    """,
+            operationId = "getMonthlyTimedActionItems"
+    )
+    @SecurityRequirement(name = "bearerAuth")
+    ResponseEntity<ApiResponse<MonthlyTimedActionItemResponse>> getMonthlyTimedActionItems(
+            @Parameter(
+                    description = "조회할 연도(1970~2100)",
+                    required = true,
+                    example = "2026"
+            )
+            @RequestParam("year") Integer year,
+
+            @Parameter(
+                    description = "조회할 월(1~12)",
+                    required = true,
+                    example = "8"
+            )
+            @RequestParam("month") Integer month
+    );
 }

src/main/java/com/tryna/domain/action/dto/MonthlyTimedActionItemResponse.java

@@ -0,0 +1,85 @@
+package com.tryna.domain.action.dto;
+
+import com.tryna.domain.action.enums.ActionItemStatus;
+import com.tryna.domain.action.enums.CreatedBy;
+import com.tryna.domain.action.enums.ItemType;
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "F104-2 월간 캘린더 내 시간형 실행 항목 조회 응답 DTO")
+public record MonthlyTimedActionItemResponse(
+
+        @Schema(description = "조회 연도", example = "2026")
+        Integer year,
+
+        @Schema(description = "조회 월", example = "8")
+        Integer month,
+
+        @Schema(description = "조회 월에 표시할 시간형 실행 항목 목록")
+        List<Item> items
+
+) {
+    @Schema(description = "월간 캘린더에 표시할 시간형 실행 항목")
+    public record Item(
+
+            @Schema(description = "준비/실행 항목 ID", example = "10")
+            Long actionItemId,
+
+            @Schema(description = "연결된 일정 ID", example = "1")
+            Long parentEventId,
+
+            @Schema(description = "항목이 속한 부모 일정 회차 날짜", example = "2026-09-02")
+            LocalDate parentOccurrenceDate,
+
+            @Schema(description = "연결된 일정 제목", example = "엄마 생신")
+            String parentEventTitle,
+
+            @Schema(description = "현재 사용자의 부모 일정 라벨 ID", example = "110")
+            Long labelId,
+
+            @Schema(description = "준비/실행 항목 제목", example = "꽃다발 준비하기")
+            String title,
+
+            @Schema(description = "항목 유형", example = "TIMED_ACTION")
+            ItemType itemType,
+
+            @Schema(description = "캘린더 표시 날짜", example = "2026-08-30")
+            LocalDate displayDate,
+
+            @Schema(description = "캘린더 표시 시간", example = "2026-08-30T09:00:00")
+            LocalDateTime displayTime,
+
+            @Schema(description = "항목 상태", example = "PENDING")
+            ActionItemStatus actionItemStatus,
+
+            @Schema(description = "항목 생성 주체", example = "SYSTEM")
+            CreatedBy createdBy,
+
+            @Schema(description = "완료 처리 일시. 미완료 상태이면 null", example = "2026-08-30T18:30:12")
+            LocalDateTime completedAt
+
+    ) {
+        public static Item from(
+                TimedActionItemResponse.Item item,
+                LocalDate parentOccurrenceDate,
+                Long labelId
+        ) {
+            return new Item(
+                    item.actionItemId(),
+                    item.parentEventId(),
+                    parentOccurrenceDate,
+                    item.parentEventTitle(),
+                    labelId,
+                    item.title(),
+                    item.itemType(),
+                    item.displayDate(),
+                    item.displayTime(),
+                    item.actionItemStatus(),
+                    item.createdBy(),
+                    item.completedAt()
+            );
+        }
+    }
+}

src/main/java/com/tryna/domain/action/repository/ActionItemsRepository.java

@@ -172,6 +172,39 @@ List<ActionItems> findCalendarActionItemsByDate(
             @Param("itemType") ItemType itemType
     );
 
+    /**
+     * 현재 사용자의 일정에 연결된 시간형 실행 항목을 표시 날짜 범위로 조회합니다.
+     *
+     * 반복 일정의 offset 기반 항목은 서비스에서 월간 회차를 동적으로 계산하므로
+     * 이 쿼리에서는 원본 displayDate를 직접 사용하는 항목만 조회합니다.
+     *
+     * @param userId 현재 사용자 ID
+     * @param startDate 조회 시작일
+     * @param endDate 조회 종료일
+     * @param itemType 항목 유형
+     * @return 조회 범위에 직접 표시할 시간형 실행 항목 목록
+     */
+    @Query("""
+            SELECT a
+              FROM ActionItems a
+              JOIN FETCH a.parentEvent e
+              JOIN UserEvents ue ON ue.event = e
+             WHERE ue.user.userId = :userId
+               AND a.displayDate BETWEEN :startDate AND :endDate
+               AND a.itemType = :itemType
+               AND e.eventStatus IN :eventStatuses
+               AND (e.isRecurring = false OR a.offsetDays IS NULL)
+               AND a.deletedAt IS NULL
+             ORDER BY a.displayDate ASC, a.displayDatetime ASC, a.actionItemId ASC
+            """)
+    List<ActionItems> findCalendarActionItemsByDateRange(
+            @Param("userId") Long userId,
+            @Param("startDate") LocalDate startDate,
+            @Param("endDate") LocalDate endDate,
+            @Param("itemType") ItemType itemType,
+            @Param("eventStatuses") Collection<EventStatus> eventStatuses
+    );
+
     /**
      * 반복 일정에 연결된 시간형 실행 항목 후보를 조회합니다.
      *