Feat/#23 학생회 공지 게시글 생성/조회/수정/삭제 기능 및 72시간 이내 행사 조회 기능 구현

src/main/java/com/campus/campus/domain/councilnotice/application/dto/request/NoticeRequest.java

@@ -0,0 +1,10 @@
+package com.campus.campus.domain.councilnotice.application.dto.request;
+
+import java.util.List;
+
+public record NoticeRequest(
+	String title,
+	String content,
+	List<String> imageUrls
+) {
+}

src/main/java/com/campus/campus/domain/councilnotice/application/dto/response/NoticeListItemResponse.java

@@ -0,0 +1,15 @@
+package com.campus.campus.domain.councilnotice.application.dto.response;
+
+import java.time.LocalDateTime;
+
+import lombok.Builder;
+
+@Builder
+public record NoticeListItemResponse(
+	Long id,
+	String title,
+	boolean isWriter,
+	LocalDateTime createdAt,
+	LocalDateTime updatedAt
+) {
+}

src/main/java/com/campus/campus/domain/councilnotice/application/dto/response/NoticeResponse.java

@@ -0,0 +1,20 @@
+package com.campus.campus.domain.councilnotice.application.dto.response;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import lombok.Builder;
+
+@Builder
+public record NoticeResponse(
+	Long id,
+	Long writerId,
+	String writerName,
+	boolean isWriter,
+	String title,
+	String content,
+	List<String> images,
+	LocalDateTime createdAt,
+	LocalDateTime updatedAt
+) {
+}

src/main/java/com/campus/campus/domain/councilnotice/application/exception/ErrorCode.java

@@ -0,0 +1,23 @@
+package com.campus.campus.domain.councilnotice.application.exception;
+
+import org.springframework.http.HttpStatus;
+
+import com.campus.campus.global.common.exception.ErrorCodeInterface;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public enum ErrorCode implements ErrorCodeInterface {
+
+	NOTICE_NOT_FOUND(2501, HttpStatus.NOT_FOUND, "공지를 찾을 수 없습니다."),
+	NOT_NOTICE_WRITER(2502, HttpStatus.FORBIDDEN, "작성자만 해당 공지를 수정하거나 삭제할 수 있습니다."),
+	NOTICE_IMAGE_LIMIT_EXCEEDED(2503, HttpStatus.BAD_REQUEST, "공지 이미지는 최대 10개까지 등록할 수 있습니다."),
+	//OCI 공지 이미지
+	NOTICE_OCI_IMAGE_DELETE_FAILED(2504, HttpStatus.INTERNAL_SERVER_ERROR, "OCI 이미지 삭제에 실패했습니다.");
+
+	private final int code;
+	private final HttpStatus status;
+	private final String message;
+}

src/main/java/com/campus/campus/domain/councilnotice/application/exception/NotNoticeWriterException.java

@@ -0,0 +1,9 @@
+package com.campus.campus.domain.councilnotice.application.exception;
+
+import com.campus.campus.global.common.exception.ApplicationException;
+
+public class NotNoticeWriterException extends ApplicationException {
+	public NotNoticeWriterException() {
+		super(ErrorCode.NOT_NOTICE_WRITER);
+	}
+}

src/main/java/com/campus/campus/domain/councilnotice/application/exception/NoticeImageLimitExceededException.java

@@ -0,0 +1,9 @@
+package com.campus.campus.domain.councilnotice.application.exception;
+
+import com.campus.campus.global.common.exception.ApplicationException;
+
+public class NoticeImageLimitExceededException extends ApplicationException {
+	public NoticeImageLimitExceededException() {
+		super(ErrorCode.NOTICE_IMAGE_LIMIT_EXCEEDED);
+	}
+}

src/main/java/com/campus/campus/domain/councilnotice/application/exception/NoticeNotFoundException.java

@@ -0,0 +1,9 @@
+package com.campus.campus.domain.councilnotice.application.exception;
+
+import com.campus.campus.global.common.exception.ApplicationException;
+
+public class NoticeNotFoundException extends ApplicationException {
+	public NoticeNotFoundException() {
+		super(ErrorCode.NOTICE_NOT_FOUND);
+	}
+}

src/main/java/com/campus/campus/domain/councilnotice/application/exception/NoticeOciImageDeleteFailedException.java

@@ -0,0 +1,9 @@
+package com.campus.campus.domain.councilnotice.application.exception;
+
+import com.campus.campus.global.common.exception.ApplicationException;
+
+public class NoticeOciImageDeleteFailedException extends ApplicationException {
+	public NoticeOciImageDeleteFailedException() {
+		super(ErrorCode.NOTICE_OCI_IMAGE_DELETE_FAILED);
+	}
+}

src/main/java/com/campus/campus/domain/councilnotice/application/mapper/StudentCouncilNoticeMapper.java

@@ -0,0 +1,58 @@
+package com.campus.campus.domain.councilnotice.application.mapper;
+
+import java.util.List;
+
+import org.springframework.stereotype.Component;
+
+import com.campus.campus.domain.council.domain.entity.StudentCouncil;
+import com.campus.campus.domain.councilnotice.application.dto.request.NoticeRequest;
+import com.campus.campus.domain.councilnotice.application.dto.response.NoticeListItemResponse;
+import com.campus.campus.domain.councilnotice.application.dto.response.NoticeResponse;
+import com.campus.campus.domain.councilnotice.domain.entity.NoticeImage;
+import com.campus.campus.domain.councilnotice.domain.entity.StudentCouncilNotice;
+
+import lombok.RequiredArgsConstructor;
+
+@Component
+@RequiredArgsConstructor
+public class StudentCouncilNoticeMapper {
+
+	public StudentCouncilNotice createStudentCouncilNotice(StudentCouncil writer, NoticeRequest dto) {
+		return StudentCouncilNotice.builder()
+			.title(dto.title())
+			.content(dto.content())
+			.writer(writer)
+			.build();
+	}
+
+	public NoticeImage createStudentCouncilNoticeImage(StudentCouncilNotice notice, String imageUrl) {
+		return NoticeImage.builder()
+			.notice(notice)
+			.imageUrl(imageUrl)
+			.build();
+	}
+
+	public NoticeResponse toNoticeResponse(StudentCouncilNotice notice, List<String> imageUrls, Long councilId) {
+		return NoticeResponse.builder()
+			.id(notice.getId())
+			.writerId(notice.getWriter().getId())
+			.writerName(notice.getWriter().getFullCouncilName())
+			.isWriter(notice.isWrittenByCouncil(councilId))
+			.title(notice.getTitle())
+			.content(notice.getContent())
+			.images(imageUrls)
+			.createdAt(notice.getCreatedAt())
+			.updatedAt(notice.getUpdatedAt())
+			.build();
+	}
+
+	public NoticeListItemResponse toNoticeListItemResponse(StudentCouncilNotice notice, Long currentUserId) {
+		return NoticeListItemResponse.builder()
+			.id(notice.getId())
+			.title(notice.getTitle())
+			.isWriter(notice.isWrittenByCouncil(currentUserId))
+			.createdAt(notice.getCreatedAt())
+			.updatedAt(notice.getUpdatedAt())
+			.build();
+	}
+}

src/main/java/com/campus/campus/domain/councilnotice/application/service/StudentCouncilNoticeService.java

@@ -0,0 +1,199 @@
+package com.campus.campus.domain.councilnotice.application.service;
+
+import java.util.List;
+
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.PageRequest;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.domain.Sort;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.campus.campus.domain.council.application.exception.StudentCouncilNotFoundException;
+import com.campus.campus.domain.council.domain.entity.StudentCouncil;
+import com.campus.campus.domain.council.domain.repository.StudentCouncilRepository;
+import com.campus.campus.domain.councilnotice.application.dto.request.NoticeRequest;
+import com.campus.campus.domain.councilnotice.application.dto.response.NoticeListItemResponse;
+import com.campus.campus.domain.councilnotice.application.dto.response.NoticeResponse;
+import com.campus.campus.domain.councilnotice.application.exception.NotNoticeWriterException;
+import com.campus.campus.domain.councilnotice.application.exception.NoticeImageLimitExceededException;
+import com.campus.campus.domain.councilnotice.application.exception.NoticeNotFoundException;
+import com.campus.campus.domain.councilnotice.application.exception.NoticeOciImageDeleteFailedException;
+import com.campus.campus.domain.councilnotice.application.mapper.StudentCouncilNoticeMapper;
+import com.campus.campus.domain.councilnotice.domain.entity.NoticeImage;
+import com.campus.campus.domain.councilnotice.domain.entity.StudentCouncilNotice;
+import com.campus.campus.domain.councilnotice.domain.repository.NoticeImageRepository;
+import com.campus.campus.domain.councilnotice.domain.repository.StudentCouncilNoticeRepository;
+import com.campus.campus.global.oci.application.service.PresignedUrlService;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class StudentCouncilNoticeService {
+
+	private static final int MAX_IMAGE_COUNT = 10;
+
+	private final StudentCouncilNoticeRepository noticeRepository;
+	private final StudentCouncilRepository studentCouncilRepository;
+	private final NoticeImageRepository noticeImageRepository;
+	private final PresignedUrlService presignedUrlService;
+	private final StudentCouncilNoticeMapper studentCouncilNoticeMapper;
+
+	@Transactional
+	public NoticeResponse create(Long councilId, NoticeRequest dto) {
+
+		if (dto.imageUrls() != null && dto.imageUrls().size() > MAX_IMAGE_COUNT) {
+			throw new NoticeImageLimitExceededException();
+		}
+
+		StudentCouncil writer = studentCouncilRepository.findByIdWithDetailsAndDeletedAtIsNull(councilId)
+			.orElseThrow(StudentCouncilNotFoundException::new);
+
+		StudentCouncilNotice notice =
+			noticeRepository.save(studentCouncilNoticeMapper.createStudentCouncilNotice(writer, dto));
+
+		if (dto.imageUrls() != null && !dto.imageUrls().isEmpty()) {
+			List<NoticeImage> images = dto.imageUrls().stream()
+				.map(imageUrl -> studentCouncilNoticeMapper.createStudentCouncilNoticeImage(notice, imageUrl))
+				.toList();
+
+			noticeImageRepository.saveAll(images);
+		}
+
+		List<String> imageUrls = noticeImageRepository
+			.findAllByNoticeOrderByIdAsc(notice)
+			.stream()
+			.map(NoticeImage::getImageUrl)
+			.toList();
+
+		return studentCouncilNoticeMapper.toNoticeResponse(notice, imageUrls, councilId);
+	}
+
+	@Transactional(readOnly = true)
+	public NoticeResponse findById(Long noticeId, Long councilId) {
+
+		StudentCouncilNotice notice = noticeRepository.findByIdWithFullInfo(noticeId)
+			.orElseThrow(NoticeNotFoundException::new);
+
+		List<String> imageUrls = noticeImageRepository
+			.findAllByNoticeOrderByIdAsc(notice)
+			.stream()
+			.map(NoticeImage::getImageUrl)
+			.toList();
+
+		return studentCouncilNoticeMapper.toNoticeResponse(notice, imageUrls, councilId);
+	}
+
+	@Transactional(readOnly = true)
+	public Page<NoticeListItemResponse> findAll(int page, int size, Long councilId) {
+
+		Pageable pageable = PageRequest.of(
+			Math.max(page - 1, 0),
+			size,
+			Sort.by(Sort.Direction.DESC, "createdAt")
+		);
+
+		Page<StudentCouncilNotice> notices = noticeRepository.findAllWithWriter(pageable);
+
+		return notices.map(notice ->
+			studentCouncilNoticeMapper.toNoticeListItemResponse(notice, councilId)
+		);
+	}
+
+	@Transactional
+	public NoticeResponse update(Long councilId, Long noticeId, NoticeRequest dto) {
+
+		if (dto.imageUrls() != null && dto.imageUrls().size() > MAX_IMAGE_COUNT) {
+			throw new NoticeImageLimitExceededException();
+		}
+
+		StudentCouncilNotice notice = noticeRepository.findByIdWithFullInfo(noticeId)
+			.orElseThrow(NoticeNotFoundException::new);
+
+		if (!notice.isWrittenByCouncil(councilId)) {
+			throw new NotNoticeWriterException();
+		}
+
+		// 업데이트 전 기존 이미지 스냅샷
+		List<NoticeImage> oldImages = noticeImageRepository.findAllByNotice(notice);
+
+		notice.update(dto.title(), dto.content());
+
+		// DB 이미지 교체
+		noticeImageRepository.deleteByNotice(notice);
+
+		if (dto.imageUrls() != null) {
+			for (String imageUrl : dto.imageUrls()) {
+				noticeImageRepository.save(
+					studentCouncilNoticeMapper.createStudentCouncilNoticeImage(notice, imageUrl));
+			}
+		}
+
+		cleanupUnusedImages(oldImages, dto);
+
+		List<String> imageUrls = noticeImageRepository
+			.findAllByNoticeOrderByIdAsc(notice)
+			.stream()
+			.map(NoticeImage::getImageUrl)
+			.toList();
+
+		return studentCouncilNoticeMapper.toNoticeResponse(notice, imageUrls, councilId);
+	}
+
+	@Transactional
+	public void delete(Long councilId, Long noticeId) {
+
+		StudentCouncilNotice notice = noticeRepository.findByIdWithFullInfo(noticeId)
+			.orElseThrow(NoticeNotFoundException::new);
+
+		if (!notice.isWrittenByCouncil(councilId)) {
+			throw new NotNoticeWriterException();
+		}
+
+		List<NoticeImage> images = noticeImageRepository.findAllByNotice(notice);
+
+		List<String> deleteTargets = images.stream()
+			.map(NoticeImage::getImageUrl)
+			.toList();
+
+		noticeImageRepository.deleteAll(images);
+		noticeRepository.delete(notice);
+
+		for (String imageUrl : deleteTargets) {
+			if (imageUrl == null || imageUrl.isBlank()) {
+				continue;
+			}
+
+			try {
+				presignedUrlService.deleteImage(imageUrl);
+			} catch (NoticeOciImageDeleteFailedException e) {
+				log.warn("OCI 파일 삭제 실패 (파일이 없을 수 있음): {}", imageUrl, e);
+			}
+		}
+	}
+
+	private void cleanupUnusedImages(List<NoticeImage> oldImages, NoticeRequest dto) {
+		List<String> newUrls = dto.imageUrls() == null ? List.of() : dto.imageUrls();
+
+		List<String> deleteTargets = oldImages.stream()
+			.map(NoticeImage::getImageUrl)
+			.filter(url -> !newUrls.contains(url))
+			.toList();
+
+		//삭제
+		for (String imageUrl : deleteTargets) {
+			if (imageUrl == null || imageUrl.isBlank()) {
+				continue;
+			}
+
+			try {
+				presignedUrlService.deleteImage(imageUrl);
+			} catch (NoticeOciImageDeleteFailedException e) {
+				log.warn("OCI 파일 삭제 실패 (파일이 없을 수 있음): {}", imageUrl, e);
+			}
+		}
+	}
+}